参考素材创作
参考所提供的图片中的场景与角色,生成角色走入庭院、停下看向镜头的片段,保持造型一致,镜头缓慢向后移动。
按当前模型支持的参考模式上传素材,描述需要保留的特征。没有匹配的模型
查看全部模型使用 Kling V3 Omni,通过文字、图片、视频输入创作视频。 支持 720p / 1080p 分辨率。 在线调整参数、预览结果,并复用素材继续创作。
{
"model": "kling-v3-omni",
"input": {
"seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"prompt": "Macro commercial film of an imaginary translucent cobalt perfume bottle on wet black stone. A soft light travels across the glass, condensation slowly forms, and the camera makes one controlled half-orbit. No logos or text."
}
}代码示例与 Playground 当前参数保持同步。
curl --request POST 'https://astralgames.ai/v1/tasks' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $MODEL_API_KEY" \
--data '{
"model": "kling-v3-omni",
"input": {
"seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"prompt": "Macro commercial film of an imaginary translucent cobalt perfume bottle on wet black stone. A soft light travels across the glass, condensation slowly forms, and the camera makes one controlled half-orbit. No logos or text."
}
}'在环境变量中设置 MODEL_API_KEY,请将密钥保存在服务端。 完整文档 ↗
先估算一次请求的费用,再选择适合工作流的预算。
| 用量 | 数量 | 单价 | 费用 |
|---|---|---|---|
| 标准 | 1 次 | $0/ 次 | $0 |
按公开美元价格估算,实际费用以账号价格与最终用量回执为准。
| 规格 | 平台价格 | 官方参考 |
|---|---|---|
| 标准 | $0 / 次 | — |
官方能力示例与本站实际生成案例分别展示,可查看各自来源。
官方能力资料 ↗ · 2026-10-14
参考所提供的图片中的场景与角色,生成角色走入庭院、停下看向镜头的片段,保持造型一致,镜头缓慢向后移动。
按当前模型支持的参考模式上传素材,描述需要保留的特征。镜头一:雨后的街道远景。镜头二:原创机器人弯腰捡起纸灯笼。镜头三:灯笼亮起的近景。保持角色外观、光线和动作衔接一致。
按镜头描述故事节奏,具体时长与分镜选项以接口为准。使用 Kling V3 Omni,通过文字、图片、视频输入创作视频。 支持 720p / 1080p 分辨率。 在线调整参数、预览结果,并复用素材继续创作。
Kling VIDEO 3.0 Omni 面向多模态参考、带声音的角色和分镜叙事,支持按镜头描述画面与节奏。
官方模型资料 ↗ · 2026-10-14
| 模型 ID | kling-v3-omni |
|---|---|
| 模型厂商 | Kuaishou |
| 调用接口 | /v1/tasks |
| 分辨率 | 720p / 1080p |
| 宽高比 | 16:9 / 9:16 / 1:1 |
| 生成时长 | 3–15 秒 |
| 参考图片 | 最多 3 个 |
| 首尾帧 | 最多 2 个 |
| 参考视频 | 最多 1 个 |
| 生成音频 | 可设置,参考视频模式可能有额外限制 |
| 规格 | Kling V3 Omni | Gemini Omni Flash | Seedance 2.0 |
|---|---|---|---|
| 厂商 | Kuaishou | ByteDance | |
| 输入 → 输出 | 文本图片视频视频 | 文本图片视频视频 | 文本图片视频音频视频 |
| 首帧 / 首尾帧 | 支持 · 1 张或 2 张图片 | — | 支持 · 1 张或 2 张图片 |
| 参考视频 | 1 | 1 | 3 |
| 参考音频 | — | — | 3 |
| 选择依据 | 当前模型 | 均声明文本、图片、视频输入 · 计费单位一致 | 均声明文本、图片、视频输入 |
| 分辨率 | 720p / 1080p | 720p | 480p / 720p / 1080p |
| 参考图片 | 3 | 20 | 9 |
| 起始价格 | $0 / 次 | $0 / 次 | $0.05 / 秒 |
根据工作流需要的输入类型、输出规格和计费单位选择模型。使用同一提示词进行试用,可以更直接地比较模型在你实际场景中的表现。
使用统一的媒体任务接口提交参数,再通过任务 ID 查询结果。图片与视频保留各自的输入要求,代码示例与你选择的模型一致。
登录并准备有权访问此模型的 Key。
在 Playground 选择参数,再复制 API 示例。
在历史记录中核对状态、产物和费用。
POST /v1/tasks · Authorization: Bearer
curl 'https://astralgames.ai/v1/tasks' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MODEL_API_KEY" \
--data '{
"model": "kling-v3-omni",
"input": {
"seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"prompt": "清晨的山间湖泊,柔和的晨光。"
}
}'const response = await fetch("https://astralgames.ai/v1/tasks", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer $MODEL_API_KEY"
},
body: JSON.stringify({
"model": "kling-v3-omni",
"input": {
"seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"prompt": "清晨的山间湖泊,柔和的晨光。"
}
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.text());import json
import requests
response = requests.post(
"https://astralgames.ai/v1/tasks",
headers=json.loads("{\"Content-Type\":\"application/json\",\"Authorization\":\"Bearer $MODEL_API_KEY\"}"),
json=json.loads("{\"model\":\"kling-v3-omni\",\"input\":{\"seconds\":5,\"resolution\":\"720p\",\"aspect_ratio\":\"16:9\",\"generate_audio\":true,\"prompt\":\"清晨的山间湖泊,柔和的晨光。\"}}"),
timeout=300,
)
response.raise_for_status()
print(response.text)使用返回的任务 ID 查询处理状态与产物。
curl -H "Authorization: Bearer $MODEL_API_KEY" "https://astralgames.ai/v1/tasks/$TASK_ID"| 参数 | 类型 | 取值与约束 |
|---|---|---|
images | array | |
prompt * | string | |
videos | array | |
seconds | integer | 默认: 5 |
resolution | JSON | "720p" · "1080p"默认: "720p" |
aspect_ratio | JSON | "16:9" · "9:16" · "1:1"默认: "16:9" |
frames_images | array | |
generate_audio | boolean | 默认: true |
{
"type": "object",
"allOf": [
{
"not": {
"required": [
"videos",
"frames_images"
]
}
},
{
"if": {
"required": [
"videos"
]
},
"then": {
"required": [
"generate_audio"
],
"properties": {
"generate_audio": {
"const": false
}
}
}
}
],
"required": [
"prompt"
],
"properties": {
"images": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"maxItems": 3,
"minItems": 1
},
"prompt": {
"type": "string",
"maxLength": 100000,
"minLength": 1
},
"videos": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"maxItems": 1,
"minItems": 1
},
"seconds": {
"type": "integer",
"default": 5,
"maximum": 15,
"minimum": 3
},
"resolution": {
"enum": [
"720p",
"1080p"
],
"default": "720p"
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16",
"1:1"
],
"default": "16:9"
},
"frames_images": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"maxItems": 2,
"minItems": 1
},
"generate_audio": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}了解模型的价格、输入要求、接入方式和结果查询。
当前公开起价为 $0 / 次,各档位详见价格区。Playground 提交前会核对账号价格,最终费用以任务或调用回执为准。
登录后点击工作区上方的 Quick Start。选择或创建有权访问此模型的 Key,再复制请求示例。
当前支持的输入字段包括:images、prompt、videos、seconds、resolution、aspect_ratio、frames_images、generate_audio。参数表列出可选值、默认值与组合约束。
可以。在参考模式中上传图片或输入 URL。 当前上限为 3 张。参考图用于引导新的生成,不代表提供 mask 局部编辑功能。
保存返回的任务 ID,持续查询到成功或失败。History 标签页可以重新打开任务并复用参数。
页面保留原模型身份并显示“暂时关闭”,禁止发起新生成,已有任务记录仍可查看。上游临时故障会与后台主动关闭分开提示。