apimodels-api-demo

APIMODELS —— 官方 API 调用示例

License: MIT Website Docs

APIMODELS 统一 API 的可运行调用示例 —— 一个 API Key、 一个兼容 OpenAI 的端点,即可调用图片、视频、大模型、语音、向量等各家模型 (GPT‑Image、Gemini、Grok、Seedance、Kling、VEO、Claude、ElevenLabs 等), 价格比直接调用各家官方低 60–95%。

English: README.md

本仓库只包含公开 API 的调用代码,不含任何密钥。API Key 由你自己在我们网站上生成。


1. 获取 API Key

  1. 到 apimodels.app 用 Google 或支付宝登录。用 Google 个人邮箱(如 Gmail、Outlook) 或支付宝注册的新用户送 $0.10 体验额度,每人一次。
  2. 进入 控制台 → API Keys,创建一个 Key。
  3. 设为环境变量(所有示例都读它):
export APIMODELS_API_KEY="sk-你的key"

切勿把 Key 硬编码或提交到 git。本地使用请把 .env.example 复制为 .env。

2. 基础地址与鉴权

   
Base URL https://api.apimodels.app/v1
鉴权头 Authorization: Bearer $APIMODELS_API_KEY
大模型/对话 兼容 OpenAI —— 把任意 OpenAI SDK 的 base_url 指到上面即可

3. 快速开始(cURL)

# 图片 —— 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" }'

4. $0.10 体验额度够跑哪些示例

体验额度是 $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 不够,先充值

花钱之前有两件事值得先知道:

生成失败不扣费。实时价格见 apimodels.app/zh/pricing。

5. 仓库内容

目录 语言 示例
curl/ Shell / cURL 图片、图片编辑、视频(含轮询)、对话、语音合成、语音转文字、音色复刻、余额
python/ Python 3 图片、视频、对话(OpenAI SDK)、向量、TTS、语音转文字、余额
node/ Node.js (ESM) 图片、视频、对话(OpenAI SDK)、TTS、语音转文字、余额

6. 覆盖的端点

能力 方法与路径 说明
图片生成 / 编辑 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。

7. 热门模型

下面每个名字都在线上实测过。拿不准时,以 curl https://api.apimodels.app/v1/models 的返回为准。

8. 返回结构

任务型端点返回:

{ "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 —— 可自由用于你自己的项目。

提示词库

每条提示词都配了它实际产出的成片或成图:

链接