Operation

Create Sora 2 Character

Create a reusable OpenAI Sora character from a hosted source video URL.

Start Here Operations Reference

Open Console OpenAPI Spec

Operation: sora2.character.create

Submit via POST /api/v1/requests

Credits: 0

Sora 2

Request fields

namesource_video_urlsource_video_name

Example request

{
  "operation": "sora2.character.create",
  "input": {
    "name": "Mara",
    "source_video_url": "https://example.com/mara-reference.mp4",
    "source_video_name": "mara-reference.mp4"
  }
}

curl -X POST https://www.cannonstudio.app/api/v1/requests \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CANNON_API_KEY" \
  -H "x-idempotency-key: sora2-character-create-001" \
  -d @- <<'JSON'
{
  "operation": "sora2.character.create",
  "input": {
    "name": "Mara",
    "source_video_url": "https://example.com/mara-reference.mp4",
    "source_video_name": "mara-reference.mp4"
  }
}
JSON

Notes

Creates an OpenAI Sora character from a hosted video URL.
The source video must be fetchable by Cannon Studio and 100 MB or smaller.
Use returned `character.id` values in `sora2.video.generate_with_characters`.

Success output

{
  "status": "completed",
  "character": {
    "id": "char_123",
    "name": "Mara",
    "sourceVideoUrl": "https://storage.googleapis.com/.../mara-reference.mp4"
  },
  "provider": "sora2",
  "model": "sora2-character"
}