Book Title Generator

Generates book titles using prompts

Try Demo

Endpoints

POST https://api.magicapi.dev/api/v1/capix/title/generate/booktitle/v1/

Description

This endpoint generates a title based on the provided description and mode. It is part of the Capix API version 2.

Headers

• x-magicapi-key: (string) A required header for authentication. Replace API_KEY with your actual API key.

• Content-Type: (string) This should be set to application/json to indicate that the request body contains JSON data.

Request Body

The request body should be a JSON object with the following fields:

• mode: (string) The mode in which the title should be generated. Example values include Formal, Casual, etc.

• description: (string) A brief description that will be used to generate the title.

Example Request Body

{
  "mode": "Formal",
  "description": "let us dive"
}

Error Handling

If the request is invalid or the token is missing/incorrect, the server will respond with an appropriate HTTP status code and a message indicating the error.

Example Error Responses

• 401 Unauthorized

  {
    "error": "Invalid token."
  }

• 400 Bad Request

  {
    "error": "Invalid request body."
  }

Notes

• Ensure that the token header contains a valid API key.

• The mode field should be one of the accepted values. Check the API documentation or contact support if you are unsure about the valid modes.

• The description field should be a concise and meaningful string to get the best results from the title generation.

Code Examples

CURL

curl -X 'POST' \
  'https://api.magicapi.dev/api/v1/capix/title/generate/booktitle/v1/' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: API_KEY' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'description=let%20us%20dive&mode=Formal'

Python

import requests

headers = {
    'accept': 'application/json',
    'x-magicapi-key': 'API_KEY',
    'Content-Type': 'application/x-www-form-urlencoded',
}

data = {
    'description': 'let us dive',
    'mode': 'Formal',
}

response = requests.post('https://api.magicapi.dev/api/v1/capix/title/generate/booktitle/v1/', headers=headers, data=data)

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.magicapi.dev/api/v1/capix/title/generate/booktitle/v1/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'accept: application/json',
    'x-magicapi-key: API_KEY',
    'Content-Type: application/x-www-form-urlencoded',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'description=let%20us%20dive&mode=Formal');

$response = curl_exec($ch);

curl_close($ch);

NodeJs

import axios from 'axios';

const response = await axios.post(
  'https://api.magicapi.dev/api/v1/capix/title/generate/booktitle/v1/',
  new URLSearchParams({
    'description': 'let us dive',
    'mode': 'Formal'
  }),
  {
    headers: {
      'accept': 'application/json',
      'x-magicapi-key': 'API_KEY'
    }
  }
);

Javascript

fetch('https://api.magicapi.dev/api/v1/capix/title/generate/booktitle/v1/', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'x-magicapi-key': 'API_KEY'
  },
  body: new URLSearchParams({
    'description': 'let us dive',
    'mode': 'Formal'
  })
});

It returns response like this

{
    "titles":[
        "Journey of Echoes",
        " Whispered Reflections",
        " Depths Unveiled"
    ]
}