Kling 图片与视频 API
Kling 图片与视频 API
OhMyToken 通过统一的异步媒体接口提供 Kling 文生图、图生图、文生视频、图生视频、首尾帧、多素材参考和视频编辑能力。本页列出当前可用的全部 Kling 模型、字段限制和完整调用示例。
快速开始
所有请求使用 OhMyToken API Key:
Base URL: https://ohmytoken.cn
Authorization: Bearer YOUR_OHMYTOKEN_API_KEY
Content-Type: application/json| 操作 | 方法 | 路径 |
|---|---|---|
| 创建图片或视频任务 | POST | /v1/media/generations |
| 查询任务 | GET | /v1/media/tasks/{TASK_ID} |
| 立即刷新一次任务状态 | GET | /v1/media/tasks/{TASK_ID}?refresh=true |
创建成功仅表示任务已进入队列:
{
"task_id": "task_example_id",
"status": "queued",
"model": "kling_v3_omni"
}请保存 task_id,并每隔 4 至 10 秒查询一次:
curl --request GET 'https://ohmytoken.cn/v1/media/tasks/task_example_id' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}"refresh=true 会立即向生成服务刷新一次状态,适合用户主动点击刷新;普通轮询不需要持续添加该参数。
模型总览
模型名区分大小写,必须与模型中心或 /v1/models 返回的名称一致。
| 模型名 | 图片能力 | 视频能力 | 时长 / 规格 |
|---|---|---|---|
kling-v2 | 单图图生图 | - | 1K/2K,1 至 4 张 |
kling-v2-1 | 文生图 | 单图图生视频 | 1K/2K;视频 5/10 秒 |
kling-v2-50turbo | - | 文生视频 | 5/10 秒,std/pro |
kling-v3 | - | 文生、图生、首尾帧 | 3 至 15 秒,音频、多镜头 |
kling-2.6 | - | 文生、图生、首尾帧 | 3 至 15 秒,仅 pro |
kling-O1 | - | 文生、图生、多素材参考 | 3/5/8/10 秒或 5/10 秒 |
kling_v3_omni | 文生图、单图/多图编辑 | 文生、图生、首尾帧、Omni 参考 | 图片 1K/2K/4K;视频 3 至 15 秒 |
kling_o1_image | 文生图、单图/多图编辑、系列图 | - | 1K/2K,最多 9 张 |
kling_o1_video | - | 文生、图生、首尾帧、多素材、视频编辑 | 3 至 10 秒,720p/1080p |
通用请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 上表中的 OhMyToken 模型名 |
capability | string | 是 | image_generation 或 video_generation |
input_mode | string | 视模式 | text、single_image、multi_image |
control_mode | string | 否 | none、end_frame、reference |
prompt | string | 通常是 | 生成描述;前 6 个模型最多 3000 字符,3 个下划线模型最多 2500 字符 |
image | string | 视模式 | 单图输入的公网 URL;视频 single_image 模式下作为首帧 |
end_image | string | 首尾帧是 | 尾帧 URL,必须与 image 一起使用 |
reference_images | string[] | 视模式 | 参考图片 URL 数组;允许只传一张 |
reference_videos | string[] | 视模式 | 参考视频 URL 数组 |
duration_seconds | integer | 视频是 | 输出视频秒数,范围由模型决定 |
negative_prompt | string | 否 | 不希望出现在结果中的内容 |
aspect_ratio | string | 否 | 常用值:1:1、4:3、3:4、16:9、9:16 |
resolution | string | 否 | 视频常用 720p/1080p/4k;官方图片使用 1k/2k/4k |
size | string | 否 | 图片尺寸别名;旧模型用 1K/2K,官方模型也接受并规范化为小写 |
with_audio | boolean | 否 | 是否生成原生同步音频 |
n | integer | 图片否 | 图片输出张数,默认 1 |
response_format | string | 图片否 | url 或模型支持的 b64_json |
extra | object | 否 | 模型高级参数,具体见各节 |
视频请求中的 single_image 表示以图片作为首帧生成视频,不表示人物、产品或风格参考。需要参考素材时使用 input_mode=multi_image、control_mode=reference 和 reference_images;即使只有一张参考图,也使用这一组合。
素材 URL 必须能通过公网 HTTP/HTTPS 访问。图片建议使用 JPG、JPEG、PNG,单张不超过 10MB、宽高至少 300px;官方视频素材支持 MP4、MOV,建议不超过 200MB。结果 URL 可能过期,任务成功后请及时保存。
kling-v2
仅支持单图图生图。capability=image_generation、input_mode=single_image、control_mode=none,size 必须为 1K 或 2K,n 为 1 至 4。
单图图生图
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v2",
"capability": "image_generation",
"input_mode": "single_image",
"control_mode": "none",
"prompt": "保持人物姿势不变,将服装改成透明玻璃材质",
"image": "https://example.com/source.png",
"size": "2K",
"n": 1,
"response_format": "url"
}'kling-v2-1
| 模式 | 关键要求 |
|---|---|
| 文生图 | input_mode=text,不能传 image,1K/2K,1 至 4 张 |
| 单图图生视频 | input_mode=single_image,时长 5 或 10 秒 |
文生图
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v2-1",
"capability": "image_generation",
"input_mode": "text",
"control_mode": "none",
"prompt": "未来感时尚大片,银色液态服装,棚拍质感",
"size": "2K",
"aspect_ratio": "16:9",
"n": 1,
"response_format": "url"
}'单图图生视频
extra.mode 可选 std 或 pro,省略时为 std。
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v2-1",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "none",
"prompt": "让人物自然向前走近,镜头轻微推进",
"image": "https://example.com/source.png",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"with_audio": false,
"extra": { "mode": "std" }
}'kling-v2-50turbo
仅支持文生视频,时长为 5 或 10 秒,extra.mode 为 std 或 pro。
文生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v2-50turbo",
"capability": "video_generation",
"input_mode": "text",
"control_mode": "none",
"prompt": "海边日落,电影感慢镜头,云层缓慢移动",
"duration_seconds": 10,
"aspect_ratio": "16:9",
"negative_prompt": "闪烁,抖动,水印",
"extra": { "mode": "pro" }
}'kling-v3
支持 3 至 15 秒视频,extra.mode 为 std 或 pro,可使用 with_audio 和多镜头参数。
extra 字段 | 类型 | 说明 |
|---|---|---|
mode | string | std 或 pro |
multi_shot | string | "true"/"false",是否启用多镜头 |
shot_type | string | 多镜头编排方式,例如 intelligence |
文生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v3",
"capability": "video_generation",
"input_mode": "text",
"control_mode": "none",
"prompt": "无人机穿过晨雾中的山谷,电影级光影",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"with_audio": true,
"extra": { "mode": "pro", "multi_shot": "true", "shot_type": "intelligence" }
}'单图图生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v3",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "none",
"prompt": "人物抬头看向天空,镜头缓慢环绕",
"image": "https://example.com/source.png",
"duration_seconds": 6,
"aspect_ratio": "16:9",
"with_audio": false,
"extra": { "mode": "std" }
}'首尾帧视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v3",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "end_frame",
"prompt": "从清晨街道自然过渡到夜晚霓虹街景",
"image": "https://example.com/start.png",
"end_image": "https://example.com/end.png",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"with_audio": true,
"extra": { "mode": "pro" }
}'kling-2.6
支持文生视频、单图图生视频和首尾帧,时长 3 至 15 秒。质量固定为 pro,所以 extra.mode 必须是 pro。
文生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-2.6",
"capability": "video_generation",
"input_mode": "text",
"control_mode": "none",
"prompt": "雨滴落在湖面,远处山峦被薄雾覆盖",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"with_audio": true,
"extra": { "mode": "pro" }
}'单图图生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-2.6",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "none",
"prompt": "让角色自然挥手并向镜头走近",
"image": "https://example.com/source.png",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"with_audio": true,
"extra": { "mode": "pro" }
}'首尾帧视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-2.6",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "end_frame",
"prompt": "镜头从室内平滑移动到窗外城市夜景",
"image": "https://example.com/start.png",
"end_image": "https://example.com/end.png",
"duration_seconds": 10,
"aspect_ratio": "16:9",
"with_audio": false,
"extra": { "mode": "pro" }
}'kling-O1
| 模式 | input_mode | control_mode | 时长 | 素材要求 |
|---|---|---|---|---|
| 文生视频 | text | none | 5、10 秒 | prompt、aspect_ratio |
| 单图图生视频 | single_image | none | 3、5、8、10 秒 | image、prompt |
| 多素材参考 | multi_image | reference | 3、5、8、10 秒 | 至少一个参考图片或视频 |
resolution 为 720p 或 1080p,省略时默认 720p。extra.mode 为 std 或 pro。
文生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-O1",
"capability": "video_generation",
"input_mode": "text",
"control_mode": "none",
"prompt": "红色跑车沿海岸公路疾驰,低机位跟拍",
"duration_seconds": 10,
"aspect_ratio": "16:9",
"resolution": "1080p",
"extra": { "mode": "pro" }
}'单图图生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-O1",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "none",
"prompt": "保持角色外观,让人物转身看向镜头",
"image": "https://example.com/character.png",
"duration_seconds": 8,
"resolution": "1080p",
"extra": { "mode": "std" }
}'多图片和视频参考
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-O1",
"capability": "video_generation",
"input_mode": "multi_image",
"control_mode": "reference",
"prompt": "保持人物外观一致,生成转身后向镜头挥手的视频",
"reference_images": [
"https://example.com/ref-front.png",
"https://example.com/ref-side.png"
],
"reference_videos": ["https://example.com/motion.mp4"],
"duration_seconds": 8,
"aspect_ratio": "16:9",
"resolution": "1080p",
"extra": { "mode": "pro" }
}'kling_v3_omni
Kling V3 Omni 同时支持图片和视频。图片分辨率为 1k、2k、4k;视频时长为 3 至 15 秒,分辨率为 720p、1080p、4k。
图片字段
| 字段 | 类型 | 说明 |
|---|---|---|
resolution / size | string | 1k、2k、4k |
n | integer | 1 至 9 |
reference_images | string[] | 多图编辑素材 |
extra.result_type | string | single 或 series |
extra.series_amount | integer/string | 系列图数量 2 至 9,或 auto |
extra.element_list | array | 元素库引用列表 |
extra.image_fidelity | number | 图片参考强度 |
extra.human_fidelity | number | 人物身份保持强度 |
extra.callback_url | string | 任务回调地址 |
extra.external_task_id | string | 客户侧业务任务 ID |
文生图
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_v3_omni",
"capability": "image_generation",
"input_mode": "text",
"prompt": "未来风格运动鞋产品图,透明亚克力展台,棚拍光影",
"resolution": "2k",
"aspect_ratio": "1:1",
"n": 2
}'单图编辑
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_v3_omni",
"capability": "image_generation",
"input_mode": "single_image",
"prompt": "保留主体,把背景替换成雨夜东京街头",
"image": "https://example.com/product.png",
"resolution": "2k",
"n": 1
}'多图编辑
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_v3_omni",
"capability": "image_generation",
"input_mode": "multi_image",
"prompt": "把第一张图人物的服装改成第二张图的面料,保持姿势与构图",
"reference_images": [
"https://example.com/person.png",
"https://example.com/fabric.png"
],
"resolution": "4k",
"n": 1,
"extra": { "result_type": "single", "human_fidelity": 0.8 }
}'视频高级字段
| 字段 | 类型 | 说明 |
|---|---|---|
with_audio | boolean | true 生成原生音频,false 关闭 |
extra.multi_shot | boolean | 是否启用多镜头 |
extra.settings | object | 其他生成设置;顶层时长、分辨率、画幅和音频优先 |
extra.options | object | 回调、外部任务 ID、水印等任务选项 |
extra.contents | array | 精确描述提示词、首尾帧、参考图、参考视频、基础视频和元素 |
文生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_v3_omni",
"capability": "video_generation",
"input_mode": "text",
"prompt": "晨雾中的山谷,航拍镜头平缓掠过松树林,电影质感",
"duration_seconds": 8,
"resolution": "1080p",
"aspect_ratio": "16:9",
"with_audio": true,
"extra": { "multi_shot": false }
}'单图图生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_v3_omni",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "none",
"prompt": "人物缓慢转身,镜头向前推进",
"image": "https://example.com/start.png",
"duration_seconds": 6,
"resolution": "1080p",
"with_audio": false
}'首尾帧视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_v3_omni",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "end_frame",
"prompt": "从日间街道自然过渡到夜晚霓虹街景",
"image": "https://example.com/day.png",
"end_image": "https://example.com/night.png",
"duration_seconds": 10,
"resolution": "4k",
"with_audio": false
}'Omni 多素材参考视频
参考模式允许只传一张图片。此时仍使用 multi_image,图片通过 reference_images 传入,不要改用 single_image。
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_v3_omni",
"capability": "video_generation",
"input_mode": "multi_image",
"control_mode": "reference",
"prompt": "参考人物外观和动作节奏,生成角色面向镜头微笑并挥手的视频",
"reference_images": ["https://example.com/character.png"],
"reference_videos": ["https://example.com/motion.mp4"],
"duration_seconds": 8,
"resolution": "1080p",
"aspect_ratio": "9:16",
"extra": { "multi_shot": true }
}'kling_o1_image
支持 1k、2k,n 为 1 至 9。result_type=series 时可通过 series_amount 请求 2 至 9 张系列图,auto 会按最多 9 张预扣并在任务完成后按实际张数结算。
文生图
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_image",
"capability": "image_generation",
"input_mode": "text",
"prompt": "极简白色背景上的香水产品广告,柔和轮廓光",
"resolution": "2k",
"aspect_ratio": "1:1",
"n": 1
}'单图编辑
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_image",
"capability": "image_generation",
"input_mode": "single_image",
"prompt": "把背景改成雪山日出,保持人物五官和服装",
"image": "https://example.com/person.png",
"resolution": "2k",
"n": 1,
"extra": { "human_fidelity": 0.9 }
}'多图编辑和系列图
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_image",
"capability": "image_generation",
"input_mode": "multi_image",
"prompt": "基于人物和产品参考,生成同一广告系列的不同构图",
"reference_images": [
"https://example.com/person.png",
"https://example.com/product.png"
],
"resolution": "2k",
"n": 1,
"extra": { "result_type": "series", "series_amount": 4 }
}'kling_o1_video
支持 720p 或 1080p。没有参考素材时(文生视频、首帧或首尾帧)时长只能是 5 或 10 秒;使用 refer_image、参考视频或基础视频时可选 3、5、8、10 秒。可通过统一字段生成,也可用 extra.contents 精确指定视频编辑素材。
文生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_video",
"capability": "video_generation",
"input_mode": "text",
"prompt": "一艘帆船穿过金色落日下的海面,远景缓慢推进",
"duration_seconds": 10,
"resolution": "1080p",
"aspect_ratio": "16:9",
"with_audio": false
}'单图图生视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_video",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "none",
"prompt": "角色自然呼吸并看向窗外,镜头轻微移动",
"image": "https://example.com/character.png",
"duration_seconds": 5,
"resolution": "1080p"
}'首尾帧视频
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_video",
"capability": "video_generation",
"input_mode": "single_image",
"control_mode": "end_frame",
"prompt": "从人物正面平滑过渡到侧面回望",
"image": "https://example.com/first.png",
"end_image": "https://example.com/last.png",
"duration_seconds": 10,
"resolution": "1080p"
}'多图片和视频参考
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_video",
"capability": "video_generation",
"input_mode": "multi_image",
"control_mode": "reference",
"prompt": "保持人物外观,参考视频中的舞蹈动作和镜头节奏",
"reference_images": ["https://example.com/character.png"],
"reference_videos": ["https://example.com/dance.mp4"],
"duration_seconds": 8,
"resolution": "1080p"
}'基础视频编辑
extra.contents 会替代自动生成的素材列表。支持的 type 包括 prompt、first_frame、last_frame、refer_image、feature_video、base_video、element。
curl --request POST 'https://ohmytoken.cn/v1/media/generations' \
--header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling_o1_video",
"capability": "video_generation",
"input_mode": "multi_image",
"control_mode": "reference",
"prompt": "把视频背景替换为未来城市,保留人物动作",
"duration_seconds": 8,
"resolution": "1080p",
"extra": {
"contents": [
{ "type": "prompt", "text": "把视频背景替换为未来城市,保留人物动作" },
{ "type": "base_video", "url": "https://example.com/input.mp4", "id": "video_1" }
],
"options": { "external_task_id": "order-1001" }
}
}'官方高级内容字段
使用 kling_v3_omni 或 kling_o1_video 时,extra.contents 中每个对象的含义如下:
type | 字段 | 用途 |
|---|---|---|
prompt | text | 提示词 |
first_frame | url | 首帧图片 |
last_frame | url | 尾帧图片 |
refer_image | url、可选 id | 参考图片 |
feature_video | url、可选 id | 动作或特征参考视频 |
base_video | url、可选 id | 待编辑的基础视频 |
element | element_id、id | Kling 元素库素材 |
顶层 duration_seconds、resolution、aspect_ratio 和 with_audio 会覆盖 extra.settings 中的同名设置,以确保提交参数、预扣和最终结算一致。包含任何参考视频或基础视频时,会按“有视频输入”价格档计费。
计费
Kling 任务提交时按请求的图片张数或视频秒数预扣,任务完成后按实际生成张数或实际视频时长结算差额。以下是默认分组基础价格;账号分组倍率可能影响最终费用,实时价格以 模型中心 为准。
现有模型
| 模型与场景 | 基础价格 |
|---|---|
kling-v2 图片 | ¥0.40 / 张 |
kling-v2-1 图片 | ¥0.10 / 张 |
kling-v2-1 视频 std / pro | ¥0.40 / ¥0.70 每秒 |
kling-v2-50turbo std / pro | ¥0.30 / ¥0.50 每秒 |
kling-v3 std 无音频 / 有音频 | ¥0.60 / ¥0.90 每秒 |
kling-v3 pro 无音频 / 有音频 | ¥0.80 / ¥1.20 每秒 |
kling-2.6 无音频 / 有音频 | ¥0.50 / ¥1.00 每秒 |
kling-O1 无视频参考 720p / 1080p | ¥0.60 / ¥0.80 每秒 |
kling-O1 有视频参考 720p / 1080p | ¥0.90 / ¥1.20 每秒 |
kling_v3_omni
| 能力 | 输入 / 音频 | 720p | 1080p | 4K |
|---|---|---|---|---|
| 图片 | 1K/2K | ¥0.20 / 张 | - | - |
| 图片 | 4K | - | - | ¥0.40 / 张 |
| 视频 | 无视频参考、无音频 | ¥0.60 / 秒 | ¥0.80 / 秒 | ¥3.00 / 秒 |
| 视频 | 无视频参考、有音频 | ¥0.80 / 秒 | ¥1.00 / 秒 | ¥3.00 / 秒 |
| 视频 | 有视频参考 | ¥0.90 / 秒 | ¥1.20 / 秒 | ¥3.00 / 秒 |
Kling O1
| 模型与场景 | 720p / 1K-2K | 1080p |
|---|---|---|
kling_o1_image 图片 | ¥0.20 / 张 | - |
kling_o1_video 无视频参考 | ¥0.60 / 秒 | ¥0.80 / 秒 |
kling_o1_video 有视频参考或基础视频 | ¥0.90 / 秒 | ¥1.20 / 秒 |
例如,kling_v3_omni 生成 8 秒、1080p、带音频且无参考视频的基础费用为 8 × ¥1.00 = ¥8.00,再乘以账号分组倍率。
任务结果
成功任务示例:
{
"task_id": "task_example_id",
"status": "succeeded",
"model": "kling_v3_omni",
"created_at": 1787115982,
"result": {
"type": "video",
"primary_url": "https://example.com/generated.mp4",
"urls": ["https://example.com/generated.mp4"],
"metadata": { "duration_seconds": 8 }
}
}| 状态 | 含义 |
|---|---|
queued | 已提交或排队中 |
running | 正在生成,可带 progress |
succeeded | 已完成,结果位于 result |
failed | 已失败,原因位于 error_message |
错误处理
| HTTP 状态 | 常见原因 |
|---|---|
400 | 参数缺失、模式组合不支持、时长或分辨率不合法 |
401 | OhMyToken API Key 无效或鉴权头错误 |
403 | 余额不足或账号没有模型权限 |
404 | 模型不可用、任务不存在或任务不属于当前账号 |
429 | 请求频率或并发超限 |
502 | 生成服务暂时不可用,或主动刷新状态失败 |
创建任务可能产生费用,不要对超时请求做无条件自动重试,以免提交重复任务。查询请求可以使用指数退避重试,并保存 task_id、模型名、请求时间和错误响应用于排查。