Vel 哇浪 AI · 接口文档

快速接入

项	值
Base URL	`https://api.velapi.cc`
鉴权	`Authorization: Bearer <你的令牌>`
生图接口	`POST /v1/images/generations`
视频接口	`POST /v1/video/generations`
对话接口	`POST /v1/chat/completions`

计费按“模型 + 参数”自动计算；具体金额以调用时实际扣费为准，每笔调用可在钱包查看用量明细。

生图模型

模型名	说明	计费规则
`gpt-image2-b`	GPT-Image-2 标准	按「质量 × 分辨率」档位计费
`gpt-image2`	福利档	仅按分辨率计费
`nano-banana2`	Nano Banana 2	按尺寸档位计费（1024/2048/4096）
`nano-banana-pro`	Nano Banana Pro	按尺寸档位计费（≤3072 / 4096）
`nano-banana`	Nano Banana 原版	按张计费

同一模型按 size / quality 参数自动匹配档位；未传 quality 按 LOW 档。

视频模型 · flux-3-video

按秒计费，按「分辨率 × 时长」计价；
分辨率：720p / 1080p；时长：5–20s（默认 8s）；
分辨率越高、时长越长，费用越高。

时长超出 5–20s 返回 400。

对话接口 · /v1/chat/completions

OpenAI 兼容，直接使用官方格式；支持流式 SSE。

鉴权：Authorization: Bearer <令牌>
流式："stream": true，事件 data: 序列，结尾 [DONE]
模型列表：GET /v1/models 拉取当前可用模型
计费：按本轮实际消耗，以实际扣费为准

充值方式

控制台 → 钱包 → 选择 支付宝 / 微信（PayServer）；
输入金额（元）→ 确认 → 弹出二维码 / 支付链接；
扫码支付 → 余额自动到账，弹「充值成功」；
到账 1:1：充多少到多少（如充值 ¥10 → 余额 +10）。

重复回调幂等：同一笔只到账一次；订单过期请关闭重开新单。

示例代码

curl · 生图

curl https://api.velapi.cc/v1/images/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image2-b",
    "prompt": "a cat on the moon",
    "size": "2048x864",
    "quality": "MEDIUM",
    "n": 1
  }'

Python · 生图

from openai import OpenAI

client = OpenAI(base_url="https://api.velapi.cc/v1",
                api_key="sk-你的令牌")
resp = client.images.generate(
    model="gpt-image2-b", prompt="a cat on the moon",
    size="2048x864", quality="MEDIUM", n=1,
)

视频

POST https://api.velapi.cc/v1/video/generations
{
  "model": "flux-3-video",
  "prompt": "city timelapse at night",
  "resolution": "1080p",      # 720p | 1080p
  "duration_seconds": 8       # 5–20
}

对话（流式 SSE）

curl https://api.velapi.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-mini",
    "messages": [
      { "role": "system", "content": "你是一个严谨的中文助手" },
      { "role": "user", "content": "用一句话解释什么是 API" }
    ],
    "stream": true
  }'
# 响应：data: {...} ... data: [DONE]

规范与限制

鉴权细节

令牌在控制台「令牌」页创建，以 sk- 开头；
请求头 Authorization: Bearer <令牌>；令牌可随时撤销。

返回格式

生图：{created, data:[{ url | b64_json }]}；
对话：官方 OpenAI 结构；视频：任务信息 + 成片 URL。

错误码

码	含义
400	参数错误（模型名/尺寸/时长等不合法）
401	令牌无效或已过期
402	余额不足
404	模型或资源不存在
429	触发限流，请稍后重试
5xx	服务端异常，请稍后重试

限额与限流

图片：单次 n ≤ 8、并发上限 20（同一令牌同时进行的图片请求）；
视频：时长 5–20s；超限分别返回 400 / 429。

更新日志

日期	变更
2026-08-18	上线文档站；新增 flux-3-video 按秒计费与对话接口说明；PayServer 充值（支付宝/微信）上线；图片并发上限 20。

常见问题

为什么模型名这么少？

按“模型 + 参数”计费：同一模型通过 size/quality/resolution/duration 自动分档，无需一堆变体名。

参数大小写

quality：LOW / MEDIUM / HIGH（大小写均可）；size 如 1024x1024。

错误码

402＝余额不足 · 401＝令牌无效 · 400＝参数错误 · 429＝限流。

联系

QQ：2357678297。