Suggest Character

POST

https://api.zebracat.ai/v1/characters/suggest

AI Characters

Generate AI character descriptions based on video content.

Required fields:

video_type — Type of input: idea, blog, or script

video_input — The content (idea text, blog URL, or script)

style_id — Visual style ID to apply

Optional fields:

video_story_style — Story style prompt

character_description — Pre-defined character description (skips AI generation)

voice_over_script — Voice over script for context

project_id — Project ID to associate with

When called via API key, returns only the character description without generating an image or task ID.

Request

Authorization

API Key

Add parameter in header

X-API-KEY

Example:

X-API-KEY: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Character suggestion.

Body

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.zebracat.ai/v1/characters/suggest' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "video_type": "string",
    "video_input": "string",
    "video_story_style": "string",
    "style_id": 0,
    "project_id": 0,
    "character_description": "string",
    "voice_over_script": "string"
}'

Response Example

200 - Example 1

{
    "status": true,
    "description": "string",
    "task_id": "string"
}

Create Character

Get Character