API 工作流程

💡

拍我平台 API 提供了一种简便的方式，可通过文本提示或图像生成视频。本指南将说明我们 API 的核心概念和工作流程。

API 架构概览

拍我AI API 遵循 RESTful 架构设计，便于集成到各类应用中。所有请求均通过 HTTPS 协议进行，确保数据传输安全，数据格式统一为 JSON。

API-KEY 认证：所有请求均需提供 API Key 进行身份校验

API接口：不同的视频生成类型对应专用接口

异步处理：视频生成是异步进行的,需要轮询视频获取结果

进度查询：可通过视频生成状态查询接口实时了解任务进度

结果获取：任务完成后，可获取生成视频的下载链接

认证（Authentication）

所有请求均需在请求头(Header)中携带：

API-Key：用于身份验证的 API 密钥

Ai-Trace-Id：每次唯一请求需使用不同的追踪 ID（若重复使用同一 ID，则不会生成新视频）

其他生成任务所需的参数

请求提交（Request Submission）

将生成任务提交到对应的接口地址：https://app-api.pixverseai.cn

💡

文生视频

图生视频

特效

首尾帧

根据接口参数文档，修改为您所需的参数值：

响应处理（Response Handling）

提交成功后，响应体中会返回一个 video_id，用于后续状态查询。

状态检查（Status Checking）

使用返回的 video_id 定期轮询视频生成状态：

结果检索（Result Retrieval）

当处理完成后，状态接口将返回 status = 1，此时可在响应中获取完整视频 URL 及其他元数据。