SRT to SCC API - Convert SRT to SCC API: Pricing, Documentation

Authentication

Every request is authenticated with your Pixazo API key in the Ocp-Apim-Subscription-Key header — the same key across every Pixazo endpoint.

SRT to SCC generate request

SubRip (.srt) carries plain-text cues with millisecond timing, which is perfect for HTML5 players but unusable for compliance workflows that require line-21 or CEA-608 caption data. Scenarist Closed Caption (.scc) encodes captions as timecoded hexadecimal control codes tied to a specific frame rate, the format broadcasters, MAM systems, and FCC-facing deliverables expect. The Pixazo caption-convert endpoint parses each SRT cue, quantizes its timing to your target frame rate, and emits valid SCC command bytes so the file drops straight into a broadcast pipeline. Because the source SRT is never modified, you can regenerate SCC at a different frame rate without re-authoring. The job runs asynchronously so long caption tracks never block your request.

Endpoint: POST https://gateway.pixazo.ai/media-tools/v1/caption-convert

Request Code

curl -X POST 'https://gateway.pixazo.ai/media-tools/v1/caption-convert' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"subtitle_url":"https://example.com/input.srt","to_format":"scc","source_format":"srt"}'

Output

{
  "request_id": "req_9f3c1a7b2e",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/req_9f3c1a7b2e"
}

Webhook (Optional)

Instead of polling, include a webhook_url in the request body and Pixazo will POST the completed job payload to that URL when the conversion finishes. The webhook body is identical to the completed-status response shown under Retrieving Results.

Request Parameters

Example Request

curl -X POST 'https://gateway.pixazo.ai/media-tools/v1/caption-convert' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"subtitle_url":"https://example.com/input.srt","to_format":"scc","source_format":"srt"}'

import requests

resp = requests.post(
    "https://gateway.pixazo.ai/media-tools/v1/caption-convert",
    headers={
        "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
  "subtitle_url": "https://example.com/input.srt",
  "to_format": "scc",
  "source_format": "srt"
},
)
print(resp.json())

const res = await fetch("https://gateway.pixazo.ai/media-tools/v1/caption-convert", {
  method: "POST",
  headers: {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"subtitle_url":"https://example.com/input.srt","to_format":"scc","source_format":"srt"}),
});
console.log(await res.json());

Response

Every request returns a request_id immediately with a QUEUED status. Use the polling_url (or a webhook) to retrieve the finished file.

{
  "request_id": "req_9f3c1a7b2e",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/req_9f3c1a7b2e"
}

Request Headers

Response Handling

The submit call returns one of the HTTP status codes below. A 202 means the job was accepted — everything else is an error you should handle.

Error Responses

Errors return a JSON body with a machine-readable code and a human-readable message.

{
  "request_id": "req_9f3c1a7b2e",
  "status": "FAILED",
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Your account balance is too low to process this request."
  }
}

Retrieving Results

Poll the status endpoint until the job reaches COMPLETED (or FAILED).

curl 'https://gateway.pixazo.ai/v2/requests/status/req_9f3c1a7b2e' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY'

Response (Completed)

{
  "request_id": "req_9f3c1a7b2e",
  "status": "COMPLETED",
  "model_id": "caption-convert",
  "output": {
    "media_url": "https://api-assets.pixazo.ai/out/result.scc",
    "media_type": "SCC"
  },
  "error": null,
  "created_at": "2026-01-01T00:00:00Z",
  "completed_at": "2026-01-01T00:00:04Z"
}

Response Fields

Status Values