官方分组

Alibaba 对话与图像 API

Qwen 对话、Z-Image Turbo 与 Wan 2.7 图像的调用方式和开放范围。

使用官方分组的 APIPool Key,Base URL 为 https://app.apipool.dev/v1。 可用状态与最新价格见 Alibaba 模型目录。

Qwen 对话

本页对话示例适用于 qwen3.6-flash、qwen3.6-plus、 qwen3.7-plus、qwen3.7-max、qwen3.8-max、qwen3.7-flash、 qwen3.8-flash、qwen3.8-27b、qwen3.8-2.4t-a95b、qwen3.8-max-0902。 调用前以目录中的可用状态为准;将示例的 model 换成目标型号。

curl https://app.apipool.dev/v1/chat/completions \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.8-flash","messages":[{"role":"user","content":"你好"}],"stream":false}'

本系列仅开放 Chat Completions。默认非流式;传 stream: true 时,最后的流式片段 包含用量。支持自定义 function tools 和隐式缓存读取。暂未开放内置搜索与工具、显式 缓存创建及 Responses。命中缓存的输入按独立费率计费,推理 token 计入输出用量。

图像生成与编辑

三款模型统一使用 JSON POST /v1/images/generations,遵循 图片异步任务流程。

调用 ID每次输出参考图分辨率
z-image-turbo固定 1 张,不传 n不支持1K(默认)、2K
wan2.7-imagen=1..4,默认 1最多 9 张1K、2K(默认)
wan2.7-image-pron=1..4,默认 1最多 9 张1K、2K(默认);纯文生图支持 4K
curl https://app.apipool.dev/v1/images/generations \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan2.7-image-pro","prompt":"水彩风格的安静花店","n":1,"size":"16:9","resolution":"4K"}'

Z-Image Turbo 的独立文生图示例(不传 n):

curl https://app.apipool.dev/v1/images/generations \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"z-image-turbo","prompt":"A blue ceramic cup on a white table","size":"1:1","resolution":"1K"}'

保存响应中的任务 id,用同一 Key 轮询 GET /v1/tasks/{id}。202 只表示提交成功; 任务达到 completed 后再下载图片,并遵守响应中的结果过期时间。

size 支持 1:1、4:3、3:4、16:9、9:16、3:2、2:3。 Wan 也允许在 size 中直接写 1K、2K 或适用的 4K,不能与 resolution 冲突。 暂不支持自定义像素尺寸。

Wan 编辑图片时在同一生成接口传 image_urls,支持 HTTP(S) 和 data:image URL。 参考图模式最高 2K,输出宽高比与最后一张参考图一致。prompt 必填,Z-Image 最多 800 个字符,Wan 最多 5000 个字符。Wan 支持字符串 negative_prompt。

Wan 参考图编辑示例;把 URL 换成服务端可访问的实际图片地址:

curl https://app.apipool.dev/v1/images/generations \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan2.7-image","prompt":"Change the cup to green","image_urls":["https://your-cdn.example/source.png"],"resolution":"2K","n":1}'

支持标准生成;暂未开放 multipart 编辑、连续生成、框选、调色板、seed、水印和 thinking 控制。prompt_extend、nsfw_check 只能省略或传 false;启用这些附加 收费服务的请求会在计费前被拒绝。

按实际成功交付张数计费,Wan 参考图及已支持的分辨率不额外收费。 当前单价见 Alibaba 模型详情。

本页图片型号使用 Images 异步协议,不使用 Chat / Responses 文字请求;可运行的完整轮询示例见提交并轮询。