# 媒體轉錄

**API:** Data API

**Endpoint:** `GET /v1/beta/instagram/media/transcript`

**Tags:** Instagram

轉錄公開 Instagram 影片或 reel 中的語音，並傳回轉錄文字，每筆包含 id、shortcode 與轉寫出的文字。目標必須是長度兩分鐘以內的影片：照片貼文會傳回 400 bad_request，因此當 URL 的類型未知時，請先用 get_instagram_post 檢查 is_video。若需要作者撰寫的說明文字而非影片中的話語，請從 get_instagram_post 讀取 edge_media_to_caption。

### 計費參考

- 計量方式：依結果筆數計量。
- 參考請求估算：0.00188 美元。
- 參考客戶倍率：1.0。不得對已結算的客戶金額再次應用。

僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `url` | query | no | string |  |

## Responses

### 200 — 成功回應

Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。

**application/json**

Schema: `ResponseA9E1Aef9F4F7_InstagramTranscriptsResponse` (`#/components/schemas/ResponseA9E1Aef9F4F7_InstagramTranscriptsResponse`)

Example:

```json
{
  "success": true,
  "transcripts": [
    {
      "id": "3597267389859272809",
      "shortcode": "DHsD6HGqJhp",
      "text": "Let's fry up the perfect bunzel. Beautiful.  Everybody, shh. The perfect bunzel. Let me show you my bunzel. When it comes down to bunzel, we make it the crispiest, get the crunch. Heaven."
    }
  ]
}
```

### 400 — 無法處理該要求。請檢查請求參數。

### 401 — 需要有效的 Felo API 金鑰。

### 402 — 由於未符合計費要求，要求無法繼續。

### 403 — 該帳戶無權執行此操作。

### 429 — 已達到要求或支出上限。

### 502 — 服務無法完成該要求。

### 503 — API 或計費服務暫時無法使用。

### 504 — 服務在處理要求時逾時。

### default — 錯誤回應；上游透傳回應可能採用供應商格式

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseA9E1Aef9F4F7_InstagramTranscriptsResponse

`#/components/schemas/ResponseA9E1Aef9F4F7_InstagramTranscriptsResponse`

```json
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "credits_remaining": {
      "type": "integer"
    },
    "transcripts": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}
```