API 接入文档

OpenAI 兼容格式。这里是快速上手;登录后在控制台「接入文档」页可以创建密钥,并查看每个模型的完整参数。

1. 准备

  1. 注册账号,联系客服微信/QQ 9684546 充值。
  2. 在控制台「接入文档」页创建并复制密钥(以 sk- 开头)。密钥只放在服务端,不要写进网页或 App 前端。
  3. 接口地址:https://aotman.vip/v1

2. 生成图片

export API_KEY="sk-你的密钥"

curl -s --max-time 300 https://aotman.vip/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5-sunburst","prompt":"桌上一只红苹果,产品摄影","size":"1024x1024","n":1}' \
  | jq -r '.data[0].b64_json' | base64 -d > out.png

可用的图片模型和价格见价格页。图片生成一般需要 30 到 70 秒,请把超时设长一些。

用 OpenAI SDK(Python)

import base64
from openai import OpenAI

client = OpenAI(base_url="https://aotman.vip/v1", api_key="sk-你的密钥", timeout=300)
img = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="白色背景上的一双运动鞋,电商主图",
    size="1024x1024",
)
open("out.png", "wb").write(base64.b64decode(img.data[0].b64_json))

3. 生成视频

视频是异步任务:先提交拿到任务 ID,再轮询进度,完成后下载。

# 提交(文生视频)
curl -s https://aotman.vip/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 你自己生成的唯一字符串" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "海边日落,镜头缓慢摇移",
    "seconds": "6",
    "size": "1280x720",
    "resolution_name": "720p"
  }'

# 返回里的 id 就是任务 ID;每 5 秒查询一次进度
curl -s https://aotman.vip/v1/videos/$TASK_ID -H "Authorization: Bearer $API_KEY"

# status 为 completed 后下载成品
curl -s -L -o out.mp4 https://aotman.vip/v1/videos/$TASK_ID/content -H "Authorization: Bearer $API_KEY"
  • 防止重复扣费:提交时带上 Idempotency-Key 请求头。网络断开后用同一个 key 重新提交,不会重复创建任务、也不会重复扣费;首次请求还在处理时会返回 409,稍等再试即可。上一次失败后重新提交,请换一个新的 key。
  • 图生视频:请求里加 "image": "图片链接或 data:image/...;base64,..."。多参考图、首尾帧等写法见控制台里的完整文档。
  • Muse 视频(muse-video):720p 带声音,seconds 填 4–180 的整数,size 只有 1280x720 和 720x1280;1 张首帧放 input_reference,多张放 images 数组(最多 4 张,第 1 张是开头画面,其余是人物、场景、画风参考)。只收 JSON。30 秒以上要 5–18 分钟出片,轮询和下载超时请给足。网页「视频创作」里最长 30 秒。
  • 视频按生成的秒数计费(15 秒长镜头按条计费),各模型支持的时长和清晰度见价格页说明。

4. 文字对话

curl https://aotman.vip/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"帮我写一句护肤精华的卖点文案"}]}'

5. 常见错误

  • 401:密钥错误或已停用,到控制台「接入文档」页检查。
  • 额度不足:联系客服充值,余额在控制台「账号信息」查看。
  • 模型当前不可用或已下架:到控制台「模型广场」或价格页查看当前可用的模型名。
  • 超时:图片请把超时设到 300 秒;视频提交后用任务 ID 轮询,不要因为超时直接重新提交(带幂等键的除外)。

每一次调用的耗时、扣费和请求 ID 都能在控制台「使用日志」里查到,反馈问题时附上请求 ID 能更快定位。客服微信/QQ:9684546(不要发送完整 API 密钥)。