> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crun.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Wan 2.7 - 参考生视频
> 使用 Wan 2.7 参考生视频模型，根据参考图片或视频生成视频。
## 时长限制
当 `reference_medias` 中任意素材包含 `reference_video` 时，`duration` 必须小于等于 10 秒。仅使用参考图片时才支持 10 秒以上的时长。
## 查询任务状态
提交任务后，使用统一查询端点查看进度并获取结果：
了解如何查询任务状态及获取生成结果
对于生产环境，我们建议在创建任务时使用 `callback_url` 参数，以便在生成完成时自动接收通知，而非持续轮询状态端点。
## 相关资源
探索所有可用模型
查询账户剩余积分
## OpenAPI
````yaml zh/models/wan/2-7-reference-to-video.json post /api/v1/client/job/CreateTask
openapi: 3.0.0
info:
title: Crun Wan 2.7 参考生视频 API
description: crun.ai Wan 2.7 视频 API 文档
version: 1.0.0
contact:
name: 技术支持
email: support@crun.ai
servers:
- url: https://api.crun.ai
description: API 服务器
security:
- ApiKeyAuth: []
paths:
/api/v1/client/job/CreateTask:
post:
summary: 使用 Wan 2.7 参考生视频生成视频
operationId: wan-2-7-r2v
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
- input
properties:
model:
type: string
enum:
- wan/2-7-r2v
description: |-
用于生成的模型名称，必填字段。
- 使用本端点时必须填写 `wan/2-7-r2v`
callback_url:
type: string
format: uri
description: |-
可选。用于接收任务完成通知的回调 URL。
- 生成完成后，系统将以 POST 方式向该 URL 推送任务状态与结果
- 回调数据结构与任务状态查询接口返回的 `data` 对象一致
- 您的回调端点需支持接收包含结果的 JSON 格式 POST 请求
- 成功接收后需返回 HTTP 200 状态码
example: https://your-domain.com/api/callback
input:
type: object
description: Wan 2.7 参考生视频生成任务的输入参数。
properties:
prompt:
type: string
description: 描述视频内容或编辑需求的文字提示词。
minLength: 1
maxLength: 5000
example: >-
A cinematic slow-motion scene of a rain-soaked city
street at night, neon reflections on the wet pavement.
negative_prompt:
type: string
description: 用于排除不需要元素的负向提示词。可选。
maxLength: 500
example: No people, no text, no logos.
reference_medias:
type: array
description: >-
参考素材列表，支持 1 到 5 个对象。每个对象需提供 `reference_image` 或
`reference_video` 之一，可选提供 `reference_voice`。
**时长规则**：
- 当任意参考素材包含 `reference_video` 时，`duration` 必须小于等于 10 秒。
- 仅使用参考图片时才支持 10 秒以上的时长。
**参考图片限制**：
- 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。
- 分辨率：宽和高的范围为 [240, 8000] 像素。
- 宽高比：1:8 到 8:1。
- 文件大小：不超过 20 MB。
**参考视频限制**：
- 格式：MP4、MOV。
- 时长：1 到 30 秒。
- 分辨率：宽度和高度范围为 [240, 4096] 像素。
- 宽高比：1:8 到 8:1。
- 文件大小：不超过 100 MB。
**参考音色音频限制**：
- 格式：WAV、MP3。
- 时长：1 到 10 秒。
- 文件大小：不超过 15 MB。
minItems: 1
maxItems: 5
items:
type: object
properties:
reference_image:
type: string
format: uri
description: |-
参考图片 URL。
**图像限制**：
- 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。
- 分辨率：宽和高的范围为 [240, 8000] 像素。
- 宽高比：1:8 到 8:1。
- 文件大小：不超过 20 MB。
reference_video:
type: string
format: uri
description: >-
参考视频 URL。
当任意 `reference_medias` 素材中提供该字段时，`duration` 必须小于等于
10 秒。
**视频限制**：
- 格式：MP4、MOV。
- 时长：1 到 30 秒。
- 分辨率：宽度和高度范围为 [240, 4096] 像素。
- 宽高比：1:8 到 8:1。
- 文件大小：不超过 100 MB。
reference_voice:
type: string
format: uri
description: >-
音频 URL。用于指定参考素材（图像/视频）中主体角色的音色。与 `reference_image`
或 `reference_video`
搭配使用。该音频仅参考音色，与说话内容无关。建议参考音频语种与提示词语种保持一致，匹配效果更佳。
**音频生效逻辑**：
- 默认行为：若 `reference_video` 本身包含音频，但未指定
`reference_voice`，默认使用视频原声。
- 优先级：若同时传入 `reference_video`（含音频）和
`reference_voice`，则优先使用 `reference_voice`
的音色，覆盖视频原声。
**音频限制**：
- 格式：WAV、MP3。
- 时长：1 到 10 秒。
- 文件大小：不超过 15 MB。
example:
- reference_image: https://example.com/reference-character.png
reference_voice: https://example.com/reference-voice.mp3
- reference_video: https://example.com/reference-motion.mp4
duration:
type: integer
description: >-
视频时长，单位为秒。支持 2 到 15 秒。当 `reference_medias` 中任意素材包含
`reference_video` 时，时长必须小于等于 10 秒。
minimum: 2
maximum: 15
default: 5
example: 10
resolution:
type: string
description: 输出视频分辨率。
enum:
- 1080P
- 720P
default: 720P
example: 1080P
aspect_ratio:
type: string
description: 生成视频的宽高比。
enum:
- '16:9'
- '9:16'
- '4:3'
- '3:4'
- '1:1'
default: '16:9'
example: '16:9'
region:
type: string
description: 服务区域。mainland：中国大陆，global：国际
enum:
- mainland
- global
nullable: true
default: null
example: global
prompt_extend:
type: boolean
description: 是否自动扩展提示词。
default: false
example: false
input_compliance:
type: string
nullable: true
description: >-
可选输入审核开关。传入 `enable` 开启输入审核，传入 `disable` 关闭；不传或传 `null`
时使用默认配置。
enum:
- disable
- enable
default: null
example: enable
output_compliance:
type: string
nullable: true
description: >-
可选输出审核开关。传入 `enable` 开启输出审核，传入 `disable` 关闭；不传或传 `null`
时使用默认配置。
enum:
- disable
- enable
default: null
example: enable
required:
- prompt
- reference_medias
example:
model: wan/2-7-r2v
callback_url: https://your-domain.com/api/callback
input:
prompt: >-
A character walking through a neon-lit alley while keeping the
reference appearance consistent.
reference_medias:
- reference_image: https://example.com/reference-character.png
reference_voice: https://example.com/reference-voice.mp3
resolution: 1080P
aspect_ratio: '16:9'
region: global
duration: 10
prompt_extend: false
input_compliance: enable
output_compliance: enable
responses:
'200':
description: 请求成功
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
data:
type: object
properties:
task_id:
type: string
description: 任务 ID，可通过获取任务详情接口查询任务状态
example: task_12345678
example:
code: 200
message: success
data:
task_id: task_12345678
'422':
description: 验证错误
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
errors:
type: array
description: 详细的验证错误信息
items:
type: string
example:
- specific error field message
example:
code: 422
message: Missing Params or Type Error
errors:
- specific error field message
'500':
$ref: '#/components/responses/Error'
components:
schemas:
ApiResponse:
type: object
properties:
code:
type: integer
enum:
- 200
- 401
- 402
- 404
- 422
- 429
- 455
- 500
- 501
- 505
description: |-
响应状态码
- **200**: 成功 - 请求已成功处理
- **401**: 未授权 - 身份凭证缺失或无效
- **402**: 额度不足 - 账户余额不足以完成本次操作
- **404**: 未找到 - 请求的资源或端点不存在
- **422**: 验证错误 - 请求参数未通过验证
- **429**: 请求限速 - 该资源的请求次数已超出限制
- **455**: 服务不可用 - 系统正在维护中
- **500**: 服务器错误 - 处理请求时发生意外错误
- **501**: 生成失败 - 内容生成任务失败
- **505**: 功能已禁用 - 所请求的功能当前已被禁用
message:
type: string
description: 响应消息，失败时为错误描述
example: success
responses:
Error:
description: 服务器错误
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: |-
所有 API 均需通过 API Key 进行身份验证。
获取 API Key：
1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取您的 API Key
使用方式：
将以下内容添加至请求头：
x-api-key: YOUR_API_KEY
注意事项：
- 请妥善保管您的 API Key，切勿与他人共享
- 若怀疑 API Key 已泄露，请立即在管理页面进行重置
````