接入文档

不想写代码？用 灵感矿 图形界面做视频

上面这套「提交任务 → 轮询 → 下载成片」是给程序调用的。 如果你只想做出片子，可以装 灵感矿 —— 它把同样的模型包成了一个画布工具：拖一个「视频生成」节点、填提示词就能出片， 还支持带声音的视频、图生视频、以及用文本模型驱动 Agent 帮你拆分镜。

流式输出（SSE）

把 stream 设为 true，服务端会以 text/event-stream 逐块返回：

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

实际返回长这样（每行一个 data: 块，最后以 data: [DONE] 结束）：

data: {"id":"chatcmpl-6d4b3948…","object":"chat.completion.chunk","created":1789404678,"model":"deepseek-v4-flash","choices":[{"index":0,"delta":{"role":"assistant","content":"","reasoning_content":""},"finish_reason":null}],"usage":null}

data: {"id":"chatcmpl-6d4b3948…","object":"chat.completion.chunk","created":1789404678,"model":"deepseek-v4-flash","choices":[{"index":0,"delta":{"content":"","reasoning_content":"我们"},"finish_reason":null}],"usage":null}

data: [DONE]

响应字段

非流式响应为标准 OpenAI 结构，实测示例（deepseek-v4-flash）：

{
  "id": "chatcmpl-24651e79-2bbd-932f-9d57-efc248685719",
  "object": "chat.completion",
  "created": 1789404677,
  "model": "deepseek-v4-flash",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "", "reasoning_content": "……" },
    "finish_reason": "length",
    "logprobs": null
  }],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 20,
    "total_tokens": 29,
    "prompt_tokens_details": { "cached_tokens": 0 },
    "completion_tokens_details": { "reasoning_tokens": 20 }
  }
}

Anthropic 协议（/v1/messages）

本站同时提供 Anthropic Messages 协议，Claude Code 等工具走这个端点：

curl https://api.ideamine.cn/v1/messages \
  -H "x-api-key: sk-你的令牌" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "你好"}]
  }'

鉴权用 x-api-key，也接受 Authorization: Bearer。

错误处理

错误统一为 JSON，形如（实测）：

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: 202609141651067882709598268d9d6dGnOAIJA)",
    "type": "new_api_error"
  }
}

排障时请把 request id 一并发给客服，我们能直接定位到这条请求。

模型清单

以接口实时返回为准：

curl https://api.ideamine.cn/v1/models -H "Authorization: Bearer sk-你的令牌"

价格与折扣见模型广场。促销中的 6 个主力模型（官方价 7~8.5 折）：

模型名与上游官方名称一致（无需加前缀）。切换模型只改 model 字段，其余代码不动。

工具接入

凡支持「自定义 OpenAI 兼容接口」的客户端都能接入。下面都是复制即用的配置。

接入前/接入后怀疑不通？先用 端点体检器：填 base_url、令牌、模型名，无需写代码，10 秒内告诉你「能不能用、快不快、错在哪」——它会逐跳检查连通性、TLS、鉴权、模型列表与真实对话延迟。

Claude Code

export ANTHROPIC_BASE_URL="https://api.ideamine.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_MODEL="kimi-k3"
claude

写进 ~/.zshrc 可持久生效；ANTHROPIC_MODEL 换成任意上文模型名即可。

Cursor

Settings → Models → 打开 OpenAI API Key，Override OpenAI Base URL 填 https://api.ideamine.cn/v1，Key 填令牌，然后 Add model 填模型名（如 kimi-k3）。

Trae / Windsurf / Zed

选择 OpenAI 兼容供应商 → Base URL https://api.ideamine.cn/v1 → 填令牌 → 自定义模型名。

Continue（VS Code / JetBrains）

编辑 ~/.continue/config.json：

{
  "models": [
    {
      "title": "算力汇 · kimi-k3",
      "provider": "openai",
      "model": "kimi-k3",
      "apiBase": "https://api.ideamine.cn/v1",
      "apiKey": "sk-你的令牌"
    }
  ]
}

OpenAI Codex CLI

export OPENAI_BASE_URL="https://api.ideamine.cn/v1"
export OPENAI_API_KEY="sk-你的令牌"
codex --model kimi-k3

Aider

export OPENAI_API_BASE="https://api.ideamine.cn/v1"
export OPENAI_API_KEY="sk-你的令牌"
aider --model openai/kimi-k3

OpenCode

编辑 ~/.config/opencode/opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ideamine": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "算力汇",
      "options": {
        "baseURL": "https://api.ideamine.cn/v1",
        "apiKey": "sk-你的令牌"
      },
      "models": { "kimi-k3": {}, "deepseek-v4-flash": {} }
    }
  }
}

Cline / Roo Code（VS Code 插件）

设置里选 OpenAI Compatible → Base URL https://api.ideamine.cn/v1 → 填令牌 → 填模型 ID。

Cherry Studio / LobeChat / NextChat / Chatbox

新增 OpenAI 供应商 → API 地址填 https://api.ideamine.cn/v1 → 填令牌 → 手动添加模型名。

Dify / n8n / FastGPT / Coze / LangChain

选 OpenAI-API-compatible 供应商 → Base URL https://api.ideamine.cn/v1 → 填令牌与模型名。

沉浸式翻译 / Bob 等翻译插件

选「自定义 OpenAI 接口」→ 地址填 https://api.ideamine.cn/v1 → 填令牌，模型建议 deepseek-v4-flash（便宜快）。

参数与限额

关于「模型参数差异」：有些推理模型只接受默认采样参数，传 temperature=0.7 会被上游直接拒绝（400）。我们选择在网关层忽略、而不是把错误抛给你，这样客户端不必为每个模型写特例。你需要知道的是：对 kimi-k3 调 temperature / top_p 不会有实际效果。想自己验证任意端点的参数兼容性，用 端点体检器——它会逐项报告哪些参数被拒绝、以及上游的原话。

计费与额度

• 按量计费，按 token 结算（输入 / 输出 / 缓存分别计价），单价见模型广场；推理模型的思维链 token 同样计费。
• 余额就是人民币：控制台显示的余额、日志里的扣费金额都是实付金额（充 ¥1 到账 ¥1，挂牌价即成交价）。
• 新账号赠送 ¥5 试用额度，可直接用于全部模型；首次充值满 ¥100 再送 ¥10；会员按等级充值多送 5%~10%（见会员权益）。
• 算一下能省多少：用成本计算器按你的月用量对比官方价与本站价（含缓存折扣）。
• 用量明细：控制台「日志」可按时间 / 模型 / 令牌筛选，含 token 数与扣费金额，支持导出。
• 额度更新为批量落库，余额与日志通常几秒~1 分钟内刷新；刚调用完立刻看到 0 消耗是正常现象。
• 充值方式：对公转账（可开票）、支付宝/微信小额（人工核对最快 5 分钟到账）、兑换码 —— 详见充值指引；在线自助充值（当面付）接入中。
• 发票：可开增值税发票，类目与流程见发票与合规。

常见问题

一定要预充值才能试吗？

不用。注册即送 ¥5 试用额度，足够跑通接入并做一次小规模压测（按 deepseek-v4-flash 约合 600 万输入 token）。

能不能只把 base_url 改过来，代码不动？

可以。本站实现的是 OpenAI / Anthropic / Gemini 官方协议，SDK 与工具通常只需改 base_url 与 key。

上游故障怎么办？

同一模型配置了多个上游，自动切换；可用率与延迟见服务状态。

如何避免超支？

给每个项目建独立令牌并设置额度上限；再对令牌开启模型白名单，限制只能调用指定模型。

数据会被留存吗？

仅保留计费与排障所需的调用元数据（模型、token 数、耗时、状态码）；不将你的请求内容用于训练。详见合规说明。

价格会变吗？

上游价格浮动时我们可能调整挂牌价，调整前 7 天站内公告并邮件通知。

弃用与兼容承诺

最后更新 2026-10-07。完整的工程改动记录见项目内 docs/ 目录。

变更记录

给 AI 工具读的文档

如果你把本站接进 AI 编程助手或自动化流程，可以直接让它读精简版机器可读文档：

https://api.ideamine.cn/docs/llms.txt

内容包含：base_url、鉴权方式、端点清单、常用模型名、限额与错误码要点。适合直接喂给 Cursor / Claude Code 之类的工具当上下文。

需要帮助？

先看服务状态；仍无法解决请联系技术支持：邮箱 knight@ideamine.cn（P1 服务不可用 30 分钟内响应）。 如果你是软件外包 / 集成商，见白标合作方案。