PixStag API文档
创建视频生成任务
查询任务
查询用户信息
创建视频生成任务
视频生成 V2 接口，通过多模态 content 数组输入（文本 / 图片 / 视频 / 音频），支持文生视频、图生视频（首尾帧）、多模态参考生视频。
请求方式
POST
请求地址
https://pixstag.com/api/v2/video_generation
请求体
model
string
模型名称。
必填
可选值:
MiniMax-H3
duration
int
生成视频时长（秒），必选，整数。
必填
可选值:
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
ratio
string
生成视频的宽高比，默认 adaptive（自动，由输入自适应选择最合适的宽高比，实际比例可在查询接口的 ratio 字段获取）。
必填
可选值:
adaptive
21:9
16:9
4:3
1:1
3:4
9:16
resolution
string
视频分辨率。 目前支持 720P, 768P, 1080P, 2K。
必填
可选值:
720P
768P
1080P
2K
callback_url
string
任务状态变更的回调通知地址。
注意，最多通知3次，通知的信息是 application/json 格式，内容与你主动查询是一致的。
收到通知后,请直接返回 SUCCESS
aigc_watermark
bool
是否在生成视频中添加 AIGC 标识水印，默认 false。
use_context_ir
bool
是否启用 Context-IR 提示词优化，默认 false。 新手同学，强烈建议开启此项，视频质量会有大幅提升，生成时间稍微增加。
return_last_frame
bool
是否同步返回尾帧，可选true/false, 默认 false。
content
[]common.ContentStruct
多模态输入内容数组，描述用于生成视频的信息。 图片，音频最大3M，视频最大5M。 图片格式: jpg,png 音频格式: mp3,wav 视频格式: mp4
必填
type
string
输入内容的类型。
可选值:
text
image_url
audio_url
video_url
text
string
文本提示词（prompt），必填：所有场景都需包含一个非空 text，描述期望生成的视频。按字符数计算长度，单个 text 最多 5000 个字符。
image_url
common.RefStruct
当 type=image_url 时的图片对象（格式 / 大小 / 尺寸 / 数量限制见上方 content 说明）。
url
string
图片，音频，视频对象的url地址或base64信息。
audio_url
common.RefStruct
当 type=audio_url 时的音频对象（参考音频，仅多模态参考场景；格式 / 大小 / 时长限制见上方 content 说明）。
url
string
图片，音频，视频对象的url地址或base64信息。
video_url
common.RefStruct
当 type=video_url 时的视频对象（参考视频，仅多模态参考场景；格式 / 大小 / 时长限制见上方 content 说明）。
url
string
图片，音频，视频对象的url地址或base64信息。
role
string
内容的位置或用途，条件必填。
first_frame：首帧图片（图生视频；仅一张图且不填 role 时默认按 first_frame 处理）。
last_frame：尾帧图片（图生视频-首尾帧，需与 first_frame 成对）。
reference_image：参考图片（多模态参考生视频）。
reference_video：参考视频（多模态参考生视频）。
reference_audio：参考音频（多模态参考生视频）。
响应
task_id
string
任务 ID，用于后续查询任务状态与结果。
CURL
查询任务
按 task_id 查询单个视频生成的状态与结果。
请求方式
GET
请求地址
https://pixstag.com/api/v2/query/video_generation/{task_id}
请求体
响应
task
common.Task
H3 任务接口返回的任务对象。
id
string
任务 ID。
model
string
任务使用的模型名称，如 MiniMax-H3。
status
string
任务状态：
queued：排队中
running：运行中
succeeded：成功
failed：失败
cancelled：已取消
error
common.TaskError
错误信息，任务成功时不返回；任务失败时返回 code 与 message。
code
string
错误码。
message
string
错误提示信息。
created_at
int
任务创建时间的 Unix 时间戳（秒）。
updated_at
int
任务状态更新时间的 Unix 时间戳（秒）。
content
common.TaskContent
任务输出内容，任务成功后返回。
url
string
视频任务产物的限时下载 URL，请及时下载或转存；过期后可重新查询获取。
last_frame_url
string
视频任务产物的尾帧限时下载 URL，请及时下载或转存；过期后可重新查询获取。
resolution
string
任务产物的分辨率。
duration
int
任务产物的时长（秒）。
usage
common.TaskUsage
本次请求的用量。视频任务返回按秒计量的字段。仅任务成功时返回。
total_seconds
int
input_seconds
int
output_seconds
int
input_image_count
int
input_audio_seconds
int
total_tokens
int
prompt_tokens
int
completion_tokens
int
ratio
string
任务产物的宽高比。
task_type
string
任务类型：generation：视频生成。
modality
string
产物模态。视频生成和视频再生成任务返回 video 。
CURL
查询用户信息
查询当前用户的基本信息，如可用积分，冻结积分，积分过期时间等。
请求方式
GET
请求地址
https://pixstag.com/api/v2/user/me
请求体
响应
user_id
string
用户ID
create_time
int
用户创建时间，时间戳
credit
int
可用积分
credit_frozen
int
冻结积分
credit_valid_time
int
用户积分过期时间，时间戳
status
int
用户状态：1-正常，2-冻结
CURL