> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyfast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# kling-v2-5-turbo

> Kling 2.5 Turbo 文生视频和图生视频旧版 API。

<Tabs>
  <Tab title="文生视频">
    ## 创建任务

    `POST /kling/v1/videos/text2video`

    <div className="kling-api-example-panel">
      ```bash cURL theme={null}
      curl --request POST \
        --url https://www.anyfast.ai/kling/v1/videos/text2video \
        --header 'Authorization: Bearer YOUR_API_KEY' \
        --header 'Content-Type: application/json' \
        --data '{
          "model_name": "kling-2.5-turbo",
          "prompt": "一艘纸船穿过雨后的街道",
          "negative_prompt": "模糊，变形",
          "duration": "5",
          "mode": "std",
          "aspect_ratio": "16:9",
          "watermark_info": {"enabled": false}
        }'
      ```

      ```json 200 theme={null}
      {"id":"860260753860210752","task_id":"860260753860210752","object":"video","model":"kling-v2-5-turbo","status":"","progress":0,"created_at":1773130665}
      ```
    </div>

    ## 请求体

    <ParamField body="model_name" type="string" required>固定为 `kling-2.5-turbo`。</ParamField>
    <ParamField body="prompt" type="string" required>正向提示词，最长 2500 字符。</ParamField>
    <ParamField body="negative_prompt" type="string">负向提示词，最长 2500 字符。</ParamField>
    <ParamField body="mode" type="string" default="std">`std` 为 720p，`pro` 为 1080p。</ParamField>
    <ParamField body="duration" type="string" default="5">可选 `5` 或 `10` 秒。</ParamField>
    <ParamField body="aspect_ratio" type="string" default="16:9">可选 `16:9`、`9:16` 或 `1:1`。</ParamField>
    <ParamField body="watermark_info" type="object">通过 `enabled` 控制是否同时生成含水印结果。</ParamField>

    ## 查询任务（单个）

    `GET /kling/v1/videos/text2video/{task_id}`

    ```bash cURL theme={null}
    curl --request GET \
      --url https://www.anyfast.ai/kling/v1/videos/text2video/TASK_ID \
      --header 'Authorization: Bearer YOUR_API_KEY'
    ```
  </Tab>

  <Tab title="图生视频">
    ## 创建任务

    `POST /kling/v1/videos/image2video`

    <div className="kling-api-example-panel">
      ```bash cURL theme={null}
      curl --request POST \
        --url https://www.anyfast.ai/kling/v1/videos/image2video \
        --header 'Authorization: Bearer YOUR_API_KEY' \
        --header 'Content-Type: application/json' \
        --data '{
          "model_name": "kling-2.5-turbo",
          "image": "https://example.com/start.png",
          "image_tail": "https://example.com/end.png",
          "prompt": "人物转身看向窗外",
          "duration": "5",
          "mode": "pro",
          "watermark_info": {"enabled": false}
        }'
      ```

      ```json 200 theme={null}
      {"id":"860260753860210752","task_id":"860260753860210752","object":"video","model":"kling-v2-5-turbo","status":"","progress":0,"created_at":1773130665}
      ```
    </div>

    ## 请求体

    <ParamField body="model_name" type="string" required>固定为 `kling-2.5-turbo`。</ParamField>
    <ParamField body="image" type="string" required>首帧图片 URL 或原始 Base64。</ParamField>
    <ParamField body="image_tail" type="string">可选尾帧；仅支持 1080p `pro` 模式。</ParamField>
    <ParamField body="prompt" type="string">正向提示词，最长 2500 字符。</ParamField>
    <ParamField body="negative_prompt" type="string">负向提示词，最长 2500 字符。</ParamField>
    <ParamField body="mode" type="string" default="std">`std` 为 720p，`pro` 为 1080p。</ParamField>
    <ParamField body="duration" type="string" default="5">可选 `5` 或 `10` 秒。</ParamField>
    <ParamField body="watermark_info" type="object">通过 `enabled` 控制是否同时生成含水印结果。</ParamField>

    ### 图片要求

    支持公开 URL 或不含 data URI 前缀的原始 Base64。支持 JPG、JPEG、PNG；文件不超过 10 MB，宽高均不小于 300 px，宽高比为 1:2.5 到 2.5:1。

    ## 查询任务（单个）

    `GET /kling/v1/videos/image2video/{task_id}`

    ```bash cURL theme={null}
    curl --request GET \
      --url https://www.anyfast.ai/kling/v1/videos/image2video/TASK_ID \
      --header 'Authorization: Bearer YOUR_API_KEY'
    ```
  </Tab>
</Tabs>

## 任务结果

<ParamField path="task_id" type="string" required>填写对应创建接口返回的任务 ID。</ParamField>

`data.task_status` 为 `submitted`、`processing`、`succeed` 或 `failed`；失败原因位于 `data.task_status_msg`。成功结果位于 `data.task_result.videos`，每项包含 `id`、`url`、`watermark_url` 和 `duration`。扣减信息可能位于 `final_unit_deduction` 和 `final_balance_deduction`。

```json 200 theme={null}
{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "request-id",
  "data": {
    "task_id": "task-id",
    "task_status": "succeed",
    "task_status_msg": "",
    "watermark_info": {"enabled": false},
    "task_result": {"videos": [{"id": "video-id", "url": "https://example.com/result.mp4", "watermark_url": "", "duration": "5"}]},
    "final_unit_deduction": "string",
    "final_balance_deduction": {"quota": "string", "list_price": "string"},
    "created_at": 1722769557708,
    "updated_at": 1722769657708
  }
}
```

<Warning>生成结果 URL 会在 30 天后清理，请及时转存。</Warning>

<Note>本页使用可灵旧版路径。Kling 2.5 Turbo 不支持音频、指定音色、多镜头、运动笔刷、运镜控制和 `cfg_scale`。</Note>

<script src="/feedback.js" />
