APIMODELS 统一 API 的可运行调用示例 —— 一个 API Key、 一个兼容 OpenAI 的端点,即可调用图片、视频、大模型、语音、向量等各家模型 (GPT‑Image、Gemini、Grok、Seedance、Kling、VEO、Claude、ElevenLabs 等), 价格比直接调用各家官方低 60–95%。
English: README.md
本仓库只包含公开 API 的调用代码,不含任何密钥。API Key 由你自己在我们网站上生成。
export APIMODELS_API_KEY="sk-你的key"
切勿把 Key 硬编码或提交到 git。本地使用请把 .env.example 复制为 .env。
| Base URL | https://api.apimodels.app/v1 |
| 鉴权头 | Authorization: Bearer $APIMODELS_API_KEY |
| 大模型/对话 | 兼容 OpenAI —— 把任意 OpenAI SDK 的 base_url 指到上面即可 |
# 图片 —— size 写成 宽x高 且不带 callback_url,这一次调用就是同步的,
# 直接返回 OpenAI 结构: { "created": ..., "data": [ { "url": "https://..." } ] }
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer $APIMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "model": "gpt-image-2-lite", "prompt": "一只在咖啡店当咖啡师的小熊猫,影棚灯光", "size": "1024x1024", "response_format": "url" }'
体验额度是 $0.10。除了音色复刻,本仓库每个示例单独都跑得起,但不能一口气全跑:光视频 一条就是 $0.088。想用体验额度看视频,就先跑视频示例;跑完还够跑对话、向量和语音合成。
| 示例 | 模型 | 单次花费 | $0.10 够吗 |
|---|---|---|---|
chat-* |
claude-sonnet-4-6 |
不到 $0.001(按 token) | 够 |
embeddings.py |
text-embedding-3-small |
不到一分钱 | 够 |
text-to-speech.* |
eleven-tts-flash |
约 $0.004(触发最低计费) | 够 |
transcribe.* |
nemotron-3.5-transcribe |
每分钟音频 $0.0025 | 够(但要你自己的音频外链) |
image-generation.* |
gpt-image-2-lite 1024×1024 |
$0.008 | 够 |
image-edit.sh |
gpt-image-2-lite 1536×1024 |
$0.015 | 够(但要你自己的图片外链) |
video-generation.* |
veo-3.1-fast-fhd |
每条 $0.088(固定价) | 单独够 —— 请第一个跑 |
voice-clone.sh |
MiniMax 音色复刻 | 每个音色一次性 $15.80 | 不够,先充值 |
花钱之前有两件事值得先知道:
veo-3.1-fast-fhd 一条 8 秒 1080p 是 $0.088(720p 版
veo-3.1-fast-hd 是 $0.08),$0.10 体验额度跑得起。很多别的视频模型比整个体验额度还贵
—— grok-video-3 最短 6 秒要 $0.24,seedance-2.0-fast 480p 最短 4 秒要 $0.28 ——
会直接返回 402 Insufficient credits。curl/voice-clone.sh 之前请先看文件开头的提示。生成失败不扣费。实时价格见 apimodels.app/zh/pricing。
| 目录 | 语言 | 示例 |
|---|---|---|
curl/ |
Shell / cURL | 图片、图片编辑、视频(含轮询)、对话、语音合成、语音转文字、音色复刻、余额 |
python/ |
Python 3 | 图片、视频、对话(OpenAI SDK)、向量、TTS、语音转文字、余额 |
node/ |
Node.js (ESM) | 图片、视频、对话(OpenAI SDK)、TTS、语音转文字、余额 |
| 能力 | 方法与路径 | 说明 |
|---|---|---|
| 图片生成 / 编辑 | POST /images/generations |
默认异步(返回 data.taskId,再轮询 GET /images/generations?task_id=)。size 传 宽x高 且不带 callback_url 时改为同步返回 OpenAI 结构。传 image_url / image_urls 即为编辑 |
| 视频生成 | POST /video/generations → GET /video/generations?task_id= |
异步,轮询取结果 |
| 对话 / 大模型 | POST /chat/completions |
兼容 OpenAI |
| 向量 Embedding | POST /embeddings |
兼容 OpenAI |
| 语音合成 TTS | POST /tts/stream |
流式返回音频字节。eleven-tts-* 系列只在这个端点上,/audio/generations 不收这些名字 |
| 其它音频(音乐 / 对话 / 配音 / MiniMax TTS) | POST /audio/generations → GET /audio/generations?task_id= |
suno-v5、eleven-dialogue、eleven-isolator、eleven-dubbing、minimax-speech-*、kling-* |
| 语音转文字(转写) | POST /audio/generations → GET /audio/generations?task_id= |
nemotron-3.5-transcribe。传 audio_url;可选 timestamps 或 target_language(二者不能同用)。结果是文本:data.resultJson 是一个 JSON 字符串,解析后读 text 和 transcript_url(完整结果 JSON,timestamps 为 true 时带词级时间戳和说话人)。每分钟音频 $0.0025;单个文件最长 60 分钟、最大 200 MB |
| 账户余额 | GET /balance |
查询剩余额度(美元),免费、只读 |
| 音色与复刻 | GET /minimax/voices、POST /minimax/voice/clone |
列出 / 复刻 / 设计自定义音色(复刻每个音色 $15.80) |
| 模型列表 | GET /models |
兼容 OpenAI,不需要 API Key —— 能调通的模型名以它为准 |
完整参数见:apimodels.app/zh/docs。
下面每个名字都在线上实测过。拿不准时,以
curl https://api.apimodels.app/v1/models 的返回为准。
gpt-image-2-lite、gpt-image-2、gemini-3-pro-image、grok-imagine-image、doubao-seedream-4-5-251128、kling-image-o1veo-3.1-fast-fhd(8 秒 1080p 每条 $0.088)、grok-video-3、seedance-2.0-fast、seedance-2.0、kling-v2-6、kling-4.0、kling-4.0-flash(720p,3–20 秒,每秒 $0.094;请求字段与 kling-4.0 相同)、minimax-h3、veo-3.1eleven-tts-flash、eleven-tts-turbo、eleven-tts-multilingual、eleven-tts-v3(都走 /tts/stream);minimax-speech-02-turbo、suno-v5(走 /audio/generations);nemotron-3.5-transcribe(语音转文字,走 /audio/generations)任务型端点返回:
{ "code": 200, "msg": "success", "data": { /* ... */ } }
异步任务返回 data.taskId;轮询对应的 GET ...?task_id=<id>,直到 data.state
为 completed(读 data.resultUrls)或 failed。
语音转文字是唯一一种结果是文本而不是文件的任务:nemotron-3.5-transcribe 任务完成后,
data.resultJson 是一个 JSON 字符串({"task", "text", "duration", "transcript_url"}),
需要再解析一次,写法见 transcribe.*;data.resultUrls[0] 就是同一个 transcript_url。
兼容 OpenAI 的那几条路径(/chat/completions、/embeddings、/models,以及同步
模式下的 /images/generations)返回 OpenAI 自己的结构。
生成结果保留 30 天,之后删除,链接随之失效,要留的请及时下载或转存。
MIT —— 可自由用于你自己的项目。
每条提示词都配了它实际产出的成片或成图: