Studio

Studio takes your video files and turns them into processed media and metadata: a preview rendition, transcript, scene analysis, thumbnails, ad context, subtitles and dubs. Each file becomes a media item with one or more jobs. Studio results that describe a title (a transcript, for example) reach the Library as proposals for a person to review.

Check cost and balanceCopy Anchor Link

curl "https://dev.app.ingenee.ai/api/v1/studio/estimate?durationSec=5400&ops=transcribe_assemblyai,thumbnails" \
  -H "Authorization: Bearer $INGENEE_API_KEY"

{
  "estimate": {
    "durationSec": 5400,
    "lines": [ { "operation": "thumbnails", "pool": "media_processing", "creditsPerMinute": 0.1, "credits": 9 } ],
    "totals": { "media_processing": 9, "media_intelligence": 90 }
  }
}

durationSec is 1 to 86,400 and ops is a comma-separated list of operation names (see Operations). An unknown name returns 422. An estimate is a quote: the binding hold is taken from the measured duration once the file has been probed. Credits live in two pools, media_processing and media_intelligence. The rates and pools in this example are illustrative; your own come from GET /v1/studio/credits.

GET /v1/studio/credits returns balances for both pools, the rates (credits per minute for each operation, with usable and an unavailableReason when an operation can't run for you), and the 50 newest ledger entries. GET /v1/studio/credits/ledger pages the full ledger with page, pageSize, pool, kind, operation and sort (when or credits).

Upload a fileCopy Anchor Link

curl -X POST https://dev.app.ingenee.ai/api/v1/studio/jobs \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{
    "source": "upload",
    "sourceRef": "the-long-night.mp4",
    "contentType": "video/mp4",
    "bytes": 2147483648,
    "catalogId": "0e578f59-bf28-455f-bc82-f0639a7575fb",
    "libraryType": "movie",
    "operations": ["thumbnails", "local_analysis"]
  }'

{
  "jobId": "a41c9e07-3b52-4d68-b1f0-7c2e5d8a9b13",
  "mediaItemId": "e0b7d3a2-6f14-4c85-9a2d-1b3c5e7f9a04",
  "uploadUrl": "https://…s3.amazonaws.com/…?X-Amz-Signature=…",
  "key": "…"
}

curl -X PUT "$UPLOAD_URL" -H "Content-Type: video/mp4" --data-binary @the-long-night.mp4

curl -X POST https://dev.app.ingenee.ai/api/v1/studio/jobs/a41c9e07-3b52-4d68-b1f0-7c2e5d8a9b13/complete-upload \
  -H "Authorization: Bearer $INGENEE_API_KEY"

{ "jobId": "a41c9e07-3b52-4d68-b1f0-7c2e5d8a9b13", "bytes": 2147483648, "library": { "createdAssetId": "7c1a3f0e-5d2b-4f6a-9a41-2f0e9d3b8c11" } }

Import from a URL or S3Copy Anchor Link

curl -X POST https://dev.app.ingenee.ai/api/v1/studio/jobs \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{ "source": "url", "sourceRef": "https://media.example.com/the-long-night.mp4", "title": "The Long Night", "operations": ["thumbnails"] }'

source is url or s3 (sourceRef is then an s3://bucket/key URI). Ingenee fetches the file itself and starts at once: 201 with { jobId, mediaItemId }. An import creates a media item, not a Library title; attach it to a title when you're ready (see Attach to a title), or pass assetId to attach from the start. Importing a source that was already imported returns 409 CONFLICT with the earlier details.jobId.

For many files, POST /v1/studio/bulk takes { "items": [{ "title", "source": "url", "sourceRef" }], "operations": […] } (up to 500 items) or an "mrssUrl" to expand a feed, and returns { batchId, created, skipped, jobs }.

OperationsCopy Anchor Link

operations on a job, and the operation names in an estimate, come from this list. Processing steps (intake, probe, preview rendition) always run; the rest run only if you ask.

If an operation can't run, the job creation returns 422 ("Not yet available") and nothing is charged.

Run operations on an item that's already processedCopy Anchor Link

curl -X POST https://dev.app.ingenee.ai/api/v1/studio/items/e0b7d3a2-6f14-4c85-9a2d-1b3c5e7f9a04/operations \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{ "operations": ["transcribe_assemblyai", "ad_context"] }'

{ "jobId": "c7d2e9f1-0a3b-4c5d-8e6f-1a2b3c4d5e6f", "operations": ["transcribe_assemblyai", "ad_context"] }

You can send 1 to 11 operations from local_analysis, transcribe_assemblyai, transcribe_elevenlabs, video_understand_twelvelabs, identify_people, credits_extract, scene_metadata, thumbnails, ad_context and editorial_pass. Each reuses what processing already produced, so it can refuse with 422 and a message such as local_analysis needs the 360p rendition, or ad_context needs a transcript or analysis. Run the prerequisite in the same call or earlier. Only one job runs per item at a time: otherwise 409 CONFLICT with details.jobId.

Resume, reprocess, and handle credit shortfallsCopy Anchor Link

A call that needs more credits than you have returns 409 INSUFFICIENT_CREDITS with the amounts in the message.

Read jobs and itemsCopy Anchor Link

Attach to a titleCopy Anchor Link

curl -X POST https://dev.app.ingenee.ai/api/v1/studio/items/e0b7d3a2-6f14-4c85-9a2d-1b3c5e7f9a04/attach \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{ "assetId": "7c1a3f0e-5d2b-4f6a-9a41-2f0e9d3b8c11" }'

{ "attached": true, "assetId": "7c1a3f0e-5d2b-4f6a-9a41-2f0e9d3b8c11", "subtitlesMaterialized": true, "adContextLinked": false }

Attaching never moves a title out of its catalog. If the title has no catalog, you must also send catalogId or newCatalogName, or the call returns 422 CATALOG_REQUIRED. If the item has a transcript, it is added to the title's subtitle tracks as a pending track for a person to review (subtitlesMaterialized: true).

Thumbnails and metadataCopy Anchor Link

• POST /v1/studio/items/{id}/thumbnails/frame grabs a still: { "orientation": "landscape", "t": 754.5 } (portrait also allowed; t in seconds, within the video's length).
• POST /v1/studio/items/{id}/thumbnails/choose picks the thumbnail for an orientation: { "orientation": "landscape", "objectId": "…" }; objectId: null returns to the default.
• PATCH /v1/studio/items/{id}/metadata edits one field, { "field": "synopsis", "value": "…" } (null reverts to the layer underneath, a list field takes an array), or re-runs the AI with your values as known truth, { "rerun": true }. A field measured from the file can't be changed inline (422).

SubtitlesCopy Anchor Link

Subtitle tracks belong to a title. AI-made tracks are proposals until approved.

curl -X POST https://dev.app.ingenee.ai/api/v1/titles/7c1a3f0e-5d2b-4f6a-9a41-2f0e9d3b8c11/subtitles/generate \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" -d '{}'

202 with { id, status: "transcribing", mediaKind }. It uses the title's media, or send mediaUrl; clipSeconds limits the length. Only one transcription runs at a time (409 CONFLICT: retry later), and a title with no media returns 400 NO_MEDIA. GET /v1/titles/{id}/subtitles lists tracks with status and locked.

Translate subtitles and dub (billed per language)Copy Anchor Link

Both take a confirmedCredits figure that must equal what Ingenee is about to hold. Get it from the estimate: the media_intelligence total for subtitle_translate or dub_per_language at the job's probedDurationSec, times the number of languages. If the rate changed, the call returns 409 COST_CHANGED with the new total; confirm again.

curl -X POST https://dev.app.ingenee.ai/api/v1/studio/jobs/a41c9e07-3b52-4d68-b1f0-7c2e5d8a9b13/dub \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{ "languages": ["es", "fr"], "confirmedCredits": 36 }'

{ "jobId": "a41c9e07-3b52-4d68-b1f0-7c2e5d8a9b13", "languages": ["es", "fr"], "heldCredits": 36, "perLanguage": 18 }

Dubbing takes up to 10 language codes and needs a measured duration (422 before processing has run). For subtitle translation on a media item use POST /v1/studio/items/{id}/translate-subs with { "languages": [{ "code": "es", "name": "Spanish" }], "confirmedCredits": 4 } (up to 8 languages); it needs a transcript first (422). Both return 202, and 409 while another job runs on the item.

Not yet availableCopy Anchor Link

• Uploads larger than 4.5 GiB (multipart upload).
• Deciding a possible-duplicate warning on a media item (attach to the existing title or keep both).
• Creating a Library title from an existing media item in one call. Attach it to a title instead.

EndpointsCopy Anchor Link