图像与多媒体
通过兼容 OpenAI 与 Vertex 的端点生成与编辑图像。
OneHop 在你对话时已经用的同一个 OpenAI 兼容 base URL 上暴露图像生成与编辑。传一个 支持图像的模型 slug,请求会按实际返回的图片张数计费。
| 操作 | 端点 | 何时 |
|---|---|---|
| 生成 | POST /v1/images/generations | 无输入图 |
| 编辑 | POST /v1/images/edits | 一张或多张输入图 |
通过筛选目录找到支持图像的模型:
curl "https://api.onehop.ai/v1/models?capability=image_generation" \
-H "Authorization: Bearer $ONEHOP_API_KEY"生成一张图
curl https://api.onehop.ai/v1/images/generations \
-H "Authorization: Bearer $ONEHOP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-image-2",
"prompt": "一张折成「一跳」的世界纸质地图",
"n": 1
}'多张变体按张计费
n 参数会生成多个变体,并按供应商实际返回的每一张图计费。部分模型对 n 有上限 ——
例如 openai/gpt-image-2 目前最多 4 张。请求超过模型允许的张数会在任何上游调用前被拒绝。
Vertex / Gemini 图像
Gemini 图像模型(如 Nano Banana)经 Vertex 兼容 base URL
https://api.onehop.ai/vertex-ai 路由。输出图片从供应商响应中读取,所以多图响应能被准确计费。
长任务与异步 job
图像和视频生成可能比一个同步 HTTP 请求该挂住的时间更长。启用后,异步 job 表面允许你 提交任务并轮询结果:
POST /v1/jobs # kind: "image_generation" | "video_generation"
GET /v1/jobs/:id
GET /v1/jobs
DELETE /v1/jobs/:id # 取消排队中的 job异步 job 仍用你的 API 密钥鉴权、预扣钱包 Credit,并走与同步请求相同的计费路径结算 ——
没有独立的计费通道。Job 状态在 queued、running、completed、failed、cancelled、
expired 之间流转。传 X-Idempotency-Key,让重试的提交返回已有 job 而不是新建一个重复任务。
视频专属的模式见 视频生成。