Skip to main content
POST
/
generation
/
create
Create media generation job
curl --request POST \
  --url https://api.animusai.co/v2/generation/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "negative_prompt": "<string>",
  "strength": 123,
  "guidance_scale": 123,
  "num_inference_steps": 123,
  "seed": 123,
  "width": 123,
  "height": 123,
  "num_images": 2,
  "generation_type": "<string>",
  "character_id": "<string>",
  "group_id": "<string>",
  "group_title": "<string>",
  "use_face_lora": true,
  "use_body_lora": true,
  "face_swap": true,
  "source_image_url": "<string>",
  "convert_to_video": true
}'
{
  "generation_id": "<string>",
  "group_id": "<string>",
  "status": "<string>",
  "message": "<string>",
  "estimated_time": 123,
  "credits_deducted": 123,
  "remaining_balance": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
prompt
string
required

Primary prompt used for generation.

negative_prompt
string
strength
number

Blend weight for image-to-image edits (0-1).

guidance_scale
number
num_inference_steps
integer
seed
integer

Fixed seed for reproducibility.

width
integer

Target width of the generated asset.

height
integer

Target height of the generated asset.

num_images
integer

Number of assets to generate. Values above 1 trigger batch mode.

Required range: x >= 1
generation_type
string

Optional manual override for the generation type.

character_id
string

Character identifier for LoRA-based renders.

group_id
string

Attach the result to an existing group.

group_title
string

Title to use when a new group is created.

use_face_lora
boolean
use_body_lora
boolean
face_swap
boolean
source_image_url
string<uri>

Source image to edit or convert.

convert_to_video
boolean

Convert the result into a short MP4 clip.

Response

Generation submission accepted.

generation_id
string
group_id
string
status
string

Submission status.

message
string
estimated_time
integer

Estimated time to completion in seconds.

credits_deducted
integer
remaining_balance
integer

Remaining credit balance for the organization.

I