Get the transcript of a video

About

A video is transcribed when a project that uses it as its source is analyzed, and the transcript is kept afterwards. This is the raw transcript: corrections made in the GPT-Video editor are not in it. While the analysis that makes it is running the answer is NOT_READY, and a video that no analysis has used answers CONFLICT.

Example use

A team that keeps a written version of every interview reads the transcript of each analyzed video and saves it next to the recording. A search tool then uses the word times to link a sentence to the moment it was said.

Endpoint

GET https://api.gpt-video.com/v1/assets/{assetId}/transcript

• Scope clips:read.
• Rate limit 120 requests a minute for each key and 240 for each account, shared by every read call. See rate limits.
• No Idempotency-Key.

Parameters

Path

Query

Request

Read the transcript of a video.

curl "https://api.gpt-video.com/v1/assets/ast_3f9a1c7e5b2d4086a1c4/transcript" \
  -H "Authorization: Bearer $GPT_VIDEO_API_KEY"

const res = await fetch("https://api.gpt-video.com/v1/assets/ast_3f9a1c7e5b2d4086a1c4/transcript", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.GPT_VIDEO_API_KEY}`,
  },
});
const data = await res.json();
console.log(data);

import os

import requests

r = requests.get(
    "https://api.gpt-video.com/v1/assets/ast_3f9a1c7e5b2d4086a1c4/transcript",
    headers={
        "Authorization": f"Bearer {os.environ['GPT_VIDEO_API_KEY']}",
    },
)
data = r.json()
print(data)

{
  "method": "tools/call",
  "params": {
    "name": "get_transcript",
    "arguments": {
      "assetId": "ast_3f9a1c7e5b2d4086a1c4"
    }
  }
}

Response

A successful call answers HTTP 200.

Response example

{
  "transcript": {
    "assetId": "ast_3f9a1c7e5b2d4086a1c4",
    "language": "en",
    "createdAt": "2026-09-01T09:20:00.000Z",
    "words": [
      {
        "text": "the",
        "startSec": 118,
        "endSec": 118.35,
        "confidence": 0.94
      },
      {
        "text": "first",
        "startSec": 118.4,
        "endSec": 118.75,
        "confidence": 0.94
      },
      {
        "text": "customer",
        "startSec": 118.8,
        "endSec": 119.15,
        "confidence": 0.94
      }
    ],
    "segments": [
      {
        "startSec": 118,
        "endSec": 152,
        "text": "the first customer paid us before we had a product"
      }
    ]
  }
}

{
  "error": {
    "code": "CONFLICT",
    "message": "This video has not been transcribed yet. Analyze a project that uses it as its source; the transcript is kept when the analysis finishes.",
    "requestId": "req_0d6a2e8c4f1b7d3a9e5c2f6b"
  }
}

{
  "error": {
    "code": "NOT_READY",
    "message": "The transcript of this video is still being made.",
    "hint": "Wait the number of seconds in the Retry-After header, then send the same request again.",
    "requestId": "req_7b3e9c1f5a0d4b8e2c6f9a3d"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Asset ast_0b1e5c9d3a7f40628e2d not found",
    "hint": "Check the id. An id that belongs to another account is not found either.",
    "requestId": "req_9e5a1c7f3b0d6e2a8c4f1b5d"
  }
}

Errors

Every call can also answer these errors. VALIDATION_FAILED, UNKNOWN_PARAMETER, UNAUTHORIZED, SCOPE_MISSING, RATE_LIMITED, INTERNAL, UNAVAILABLE.

Cost

No credits are used.

Related operations

• get_asset (GET /v1/assets/{assetId}) Get an asset
• list_assets (GET /v1/assets) List your videos
• analyze_project (POST /v1/projects/{projectId}/analyze) Analyze a project

Questions

Why are my corrections from the editor missing?

This is the transcript as speech recognition produced it. Corrections made in the editor belong to a composition and change only its captions. This transcript stays as it was.

How do I get a transcript for a video?

Create a project with the video as its source and analyze it. The transcript is made during the analysis and stays with the video.

View as Markdown