Generate with Visual Effect

Apply a preset Visual Effect to a character. This works the same as the V1 Generate with Visual Effect, but uses a character ID instead of an image URL.

Request

https://open.eternalai.org/v2/generate

curl --location 'https://open.eternalai.org/v2/generate' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <YOUR_API_KEY>' \
--data '{
    "images": ["6870"],
    "effect_id": "57421d3726265d3257260c"
}'

Parameter	Type	Required	Description
`images`	array	Yes	An array containing a single character ID (as a string). Only character IDs are accepted — image URLs and base64 are not supported in V2.
`effect_id`	string	Yes	The unique identifier of the Visual Effect to apply. Get list of effect_id
`duration`	int	No	Duration of the video effect in seconds. Only used for video effects. Range: `1 - 5`
`audio`	boolean	No	Only used for video effects. Default: `true`

warning

The images field in V2 only accepts character IDs. Image URLs and base64-encoded images are not supported. Use the Characters API to create a character first.

Response Example

{
    "request_id": "d633991f-6b68-4c75-a2c0-76f7f1c099c8",
    "status": "pending",
    "result": "",
    "progress": 0,
    "credits_remaining": 623.6
}

Parameter	Type	Description
`request_id`	string	Unique identifier of the request to get result.
`status`	string	Current status of the request (e.g. pending, success).
`result`	string	Result data returned after processing.
`progress`	integer	Processing progress percentage.
`credits_remaining`	number	Remaining credits after this request.

Poll for Result

Periodically call the following API with the request_id obtained from the previous step to poll for the result.

https://open.eternalai.org/v2/poll-result/{REQUEST_ID}

curl --location 'https://open.eternalai.org/v2/poll-result/$REQUEST_ID'

On success, the response contains a result_url field — a signed URL for retrieving the generated image or video.

{
    "request_id": "d633991f-6b68-4c75-a2c0-76f7f1c099c8",
    "status": "success",
    "progress": 99,
    "result_url": "https://cdn.eternalai.org/agent_data/2026/03/31/img-generated-d633991f-6b68-4c75-a2c0-76f7f1c099c8_1774937856.jpg",
    "effect_type": "image",
    "encrypted_aes_key": ""
}

Parameter	Type	Description
`request_id`	string	Unique identifier for the generation request.
`status`	string	Final status of the request (e.g. `success`, `pending`, `failed`).
`progress`	integer	Progress indicator of the generation process.
`result_url`	string	URL of the generated output image or video.
`effect_type`	string	Type of generation performed (e.g. `image`, `video`).

Generated Output

Request​

Poll for Result​

Request

Poll for Result