文档中心 - Gaia Video Factory

快速开始

三步完成接入：创建 Key、选择 Base URL、开始调用模型。

创建 API Key

注册/登录后创建自己的 Gaia API Key，完整密钥只显示一次。

阅读文档 充值与余额

了解账户级共享余额、充值申请和模型扣费规则。

阅读文档 查看使用统计

确认 LLM、生图、视频调用都进入统一请求记录。

阅读文档 邀请奖励

分享邀请链接，系统会记录注册关系和奖励入账状态。

阅读文档

API 参考

目前已接入统一网关、Image2 生图和 Grok 视频转发。

Unified Base URLhttps://api.gaiavideofactory.com/v1

Universal API Keysk-ga_...

LLM Modelgpt-5.4-mini

Image Modelgpt-image-2 或 image2

Async ImagePOST /v1/images/generations/async

Video Modelgrok-imagine-video

Async VideoPOST /v1/videos/async

curl https://api.gaiavideofactory.com/v1/models \
  -H "Authorization: Bearer sk-ga_xxx"

异步图生视频

推荐带参考图的视频生成使用异步接口。网关会先返回任务 ID，再在后台提交给 Grok、轮询状态并保存最终视频。

提交任务POST https://api.gaiavideofactory.com/v1/videos/async

兼容写法POST https://api.gaiavideofactory.com/v1/videos?async=true

查询状态GET /v1/videos/async/{job_id}

下载成片GET /v1/videos/async/{job_id}/content

curl -X POST "https://api.gaiavideofactory.com/v1/videos/async" \
  -H "Authorization: Bearer sk-ga_xxx" \
  -F "model=grok-imagine-video" \
  -F "prompt=雨夜街头，镜头缓慢推进，电影感真实光影" \
  -F "seconds=6" \
  -F "size=1280x720" \
  -F "resolution_name=720p" \
  -F "preset=normal" \
  -F "input_reference[]=@/path/to/image.png"

curl "https://api.gaiavideofactory.com/v1/videos/async/vidjob_xxx" \
  -H "Authorization: Bearer sk-ga_xxx"

curl -L "https://api.gaiavideofactory.com/v1/videos/async/vidjob_xxx/content" \
  -H "Authorization: Bearer sk-ga_xxx" \
  -o result.mp4

异步生图

推荐慢速生图任务使用异步接口，提交后立即返回任务 ID，避免浏览器、客户服务器或 Cloudflare 等待超时。

提交任务POST https://api.gaiavideofactory.com/v1/images/generations/async

兼容写法POST https://api.gaiavideofactory.com/v1/images/generations?async=true

查询状态GET /v1/images/generations/async/{job_id}

获取结果GET /v1/images/generations/async/{job_id}/result

curl -X POST "https://api.gaiavideofactory.com/v1/images/generations/async" \
  -H "Authorization: Bearer sk-ga_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "cinematic product photo, clean studio lighting",
    "size": "1024x1024"
  }'

curl "https://api.gaiavideofactory.com/v1/images/generations/async/imgjob_xxx" \
  -H "Authorization: Bearer sk-ga_xxx"

curl "https://api.gaiavideofactory.com/v1/images/generations/async/imgjob_xxx/result" \
  -H "Authorization: Bearer sk-ga_xxx"

客户端配置

任何支持 OpenAI-compatible Provider 的客户端，都可以用 Gaia API Key 接入。

OpenAI SDK

Base URL 设置为 https://api.gaiavideofactory.com/v1，LLM 模型固定使用 gpt-5.4-mini。

Build with Gaia Video Factory

快速开始

API 参考

异步图生视频

异步生图

客户端配置