Script

Script generation shares the authentication, callbacks and errors documented in the Overview.

Create a script task

POST /api/v3/contents/scripts — generates a text storyboard only: the same v3 director as the video path, but it stops after writing the script — no character/background images and no video render. Flat priced at $0.01 per script regardless of length. duration scales how many scenes the script has. On success the task carries content.script (title, character names, and per-scene setting / beat / durationSeconds).

curl -s -X POST "$TOKENSTORE_URL/api/v3/contents/scripts" \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seahorse-script",
    "content": [
      {"type": "text", "text": "a lonely lighthouse keeper finds a message in a bottle"}
    ],
    "duration": 30,
    "callback_url": "https://example.com/webhooks/nureta-developer"
  }'
# => {"id": "cgt-..."}

model is required (seahorse-script); content is exactly one text item (the story idea); duration is optional, an integer 5–180 seconds (default 30), and scales the scene count but not the price. callback_url/callback_secret work as elsewhere.

Retrieve a script task

GET /api/v3/contents/scripts/:id — poll until status is succeeded or failed. On success the response carries content.script; on failure it carries an error and the $0.01 is refunded automatically.

curl -s "$TOKENSTORE_URL/api/v3/contents/scripts/cgt-..." \
  -H "Authorization: Bearer sk-..."
# => {"id":"cgt-...","status":"succeeded","content":{"script":{
#      "title":"The Bottle","characters":["Elias"],
#      "scenes":[{"index":1,"setting":"A storm-lashed lighthouse",
#                 "beat":"Elias spots a bottle bobbing in the surf","durationSeconds":8}]}},
#      "usage":{"price_usd":0.01,"refunded":false}}

GET /api/v3/scripts/models (public) returns the script model and its flat per-script price.