# 算力汇 · API 接入速览（llms.txt）

> 面向前端/后端/AI 编程助手的精简接入说明。人类可读版：https://api.ideamine.cn/docs/

## 基本信息

- Base URL: `https://api.ideamine.cn/v1`
- 根地址（部分工具要求）: `https://api.ideamine.cn`
- 鉴权: `Authorization: Bearer sk-<令牌>`；Anthropic 协议用 `x-api-key: sk-<令牌>`
- 协议: OpenAI（Chat Completions / Responses / Embeddings / Images / Audio / Rerank）、Anthropic Messages、Gemini（`/v1beta`）
- 模型名与上游官方名称一致，例如 `deepseek-v4-flash`、`glm-5.3`、`qwen3.8-max`、`kimi-k3`
- 价格（人民币、按 1M token）与折扣：https://api.ideamine.cn/pricing
- 实时可用率与延迟：https://api.ideamine.cn/status/
- 新注册账号自动赠送 ¥5 试用额度，可直接调用全部模型

## 端点

| 方法 | 路径 | 说明 |
|---|---|---|
| GET | `/v1/models` | 列出当前可用模型 |
| POST | `/v1/chat/completions` | 对话补全（主力） |
| POST | `/v1/completions` | 文本补全 |
| POST | `/v1/responses` | OpenAI Responses 协议 |
| POST | `/v1/messages` | Anthropic Messages 协议（Claude Code） |
| POST | `/v1/embeddings` | 向量 |
| POST | `/v1/images/generations` | 图像生成 |
| POST | `/v1/audio/speech` | 语音合成 |
| POST | `/v1/audio/transcriptions` | 语音转写 |
| POST | `/v1/videos` | **视频生成（异步）** 提交任务 |
| GET | `/v1/videos/{task_id}` | 查询视频任务状态 |
| GET | `/v1/videos/{task_id}/content` | 下载成片 MP4 |
| POST | `/v1/rerank` | 重排序 |
| POST | `/v1/moderations` | 内容审核 |
| GET | `/v1/dashboard/billing/usage` | 用量查询 |

## 最简调用

```bash
curl https://api.ideamine.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}]}'
```

```python
from openai import OpenAI
client = OpenAI(api_key="sk-你的令牌", base_url="https://api.ideamine.cn/v1")
resp = client.chat.completions.create(model="deepseek-v4-flash",
                                      messages=[{"role": "user", "content": "你好"}])
print(resp.choices[0].message.content)
```

## 要点

- 流式：`"stream": true`，返回 SSE，以 `data: [DONE]` 结束；流式超时 300 秒，客户端读超时请设 ≥300s，并关闭中间层缓冲。
- 推理类模型响应含 `message.reasoning_content`（思维链），**思维链同样计费并占用 `max_tokens`**；`max_tokens` 过小会出现正文为空且 `finish_reason="length"`。
- 请求体上限 128MB；API 限流 360 次 / 180 秒（按来源 IP），超出返回 429，请加指数退避。
- 余额即人民币：充 ¥1 到账 ¥1，控制台余额与日志扣费金额都是实付金额；额度为批量落库，通常几秒~1 分钟内刷新。
- 扣费按 token：输入 / 输出 / 缓存分别计价；`usage.prompt_tokens_details.cached_tokens` 为命中缓存部分。
- 错误格式：`{"error":{"code":"","message":"Invalid token (request id: …)","type":"new_api_error"}}`；报障请带上 `request id`。
- 常见错误：401 令牌错误；403 令牌模型/IP 白名单限制；404 模型名错误（用 `/v1/models` 查）；429 限流；额度不足为 `insufficient_user_quota`。
- 工具接入：Claude Code 用 `ANTHROPIC_BASE_URL=https://api.ideamine.cn` + `ANTHROPIC_AUTH_TOKEN=sk-…`；
  其余 OpenAI 兼容工具（Cursor / Continue / Cline / Aider / Codex CLI / Cherry Studio / Dify / LangChain 等）填 Base URL `https://api.ideamine.cn/v1` 与令牌即可。
- Gemini CLI 原生不支持自定义端点，需走支持自定义地址的分支或代理。

## 联系方式

- 文档：https://api.ideamine.cn/docs/
- 控制台：https://api.ideamine.cn/console
- 邮箱：knight@ideamine.cn（P1 服务不可用 30 分钟内响应）

## 视频生成（Seedance）—— 异步，三步走

**不要用文本模型的方式调用**：视频是异步任务，必须「提交 → 轮询 → 下载」。

```bash
# 1) 提交
curl https://api.ideamine.cn/v1/videos -H "Authorization: Bearer sk-<令牌>" \
  -H "Content-Type: application/json" \
  -d '{"model":"Doubao-Seedance-2.0-fast","prompt":"一只橘猫坐在窗台上","seconds":"4","size":"1280x720"}'
# → {"id":"task_xxx","status":"queued", ...}

# 2) 轮询（每 15~30 秒一次）
curl https://api.ideamine.cn/v1/videos/task_xxx -H "Authorization: Bearer sk-<令牌>"
# → status: queued → in_progress → completed / failed

# 3) 完成后下载
curl -L https://api.ideamine.cn/v1/videos/task_xxx/content -H "Authorization: Bearer sk-<令牌>" -o out.mp4
```

**模型与价格（按秒计费）**

| 模型 | 单价 | 4 秒 | 10 秒 |
|---|---|---|---|
| `Doubao-Seedance-2.0-fast` | ¥0.99/秒 | ¥3.96 | ¥9.90 |
| `Doubao-Seedance-2.0` | ¥1.23/秒 | ¥4.92 | ¥12.30 |

**请求参数**

- `model`（必填）：上面两个之一
- `prompt`（必填）：画面描述
- `seconds`（可选，默认 4）：**必须是字符串**，如 `"4"`。
  传数字会报 `json: cannot unmarshal number into ... seconds of type string`
- `size`（可选）：`1280x720`（默认，横屏 16:9）／`720x1280`（竖屏 9:16）／`1792x1024`／`1024x1792`
- `resolution`（可选）：`720p`（默认）／`1080p`；不传由 `size` 推导
- `ratio`（可选）：`16:9`／`9:16`；不传由 `size` 推导

**注意**

- 提交时预扣额度，任务完成后按实际时长结算；**失败自动退还**
- 4 秒 720p 通常 2~3 分钟；时长/分辨率越高越久
- 必须先轮询到 `completed` 再取 `/content`，否则报 `artifact_gone`
- 余额不足以预扣会直接返回 `insufficient_user_quota`（视频单价是文本的几百倍）