EcoPhase 文档 - EcoToken 快速接入

1. 创建 API Key

进入 EcoToken 控制台的“API Key”页面，创建一个服务级 API Key。页面始终以掩码展示，登录后可点击复制图标获取当前用户的完整 API Key。仍建议将其保存到密码管理器或安全的环境变量中。

API Key 处于“同步中”时不能调用模型。等待状态变为“已生效”后再继续。

2. 确认模型与价格

进入 EcoToken 工作台，在左侧导航栏点击“模型与定价”，然后在表格的“模型 ID”列点击复制图标，即可复制准确的模型 ID。

3. 调用示例

在 cURL、Python 和 Node.js 示例之间切换。OpenAI SDK 的 Base URL 固定为 https://ecotoken.ecophase-ai.com/v1，不要再次拼接 /v1。

curl "https://ecotoken.ecophase-ai.com/v1/chat/completions" \
  -H "Authorization: Bearer $ECOTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"stream":false}'

4. 传入图片（Vision）

deepseek-v4.1-flash 支持在模型请求中传入图片。图片可以使用上游能够访问的 HTTPS URL，也可以把本地图片编码为 Base64 后以内联数据传入。

下面是 Chat Completions 的图片 URL 示例：

curl "https://ecotoken.ecophase-ai.com/v1/chat/completions" \
  -H "Authorization: Bearer $ECOTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"deepseek-v4.1-flash",
    "messages":[{
      "role":"user",
      "content":[
        {"type":"text","text":"请描述这张图片"},
        {"type":"image_url","image_url":{"url":"https://example.com/image.png"}}
      ]
    }],
    "stream":false
  }'

传入本地图片时，将 image_url.url 改为 data:image/png;base64,BASE64_DATA。不同兼容接口使用各自的图片结构：

接口	图片结构
`/v1/chat/completions`	`{"type":"image_url","image_url":{"url":"https://..."}}`；URL 也可以是 Base64 data URI
`/v1/responses`	`{"type":"input_image","image_url":"https://..."}`；`image_url` 是字符串，也可以是 Base64 data URI
`/v1/messages`	Anthropic `image` block；`source.type` 必须是 `base64`，支持 PNG、JPEG、GIF 和 WebP

只有声明支持 Vision 的模型可以接收图片。目前请使用准确的模型 ID deepseek-v4.1-flash；其他模型收到图片内容时会返回 403 permission_error。图片会被折算为输入 Token，并按该模型现有的输入 Token 单价计费。

常见错误

401：API Key 无效、尚未生效或已吊销。
402：账户可用余额不足。
403：API Key 没有服务或模型权限。
429：触发速率或并发限制；按 Retry-After 重试。
503：没有可用上游，或计费预留服务暂不可用。
504：上游请求超时。

生成类 POST 请求不会由入口自动重试。流式请求中断时，已经产生的 Token 仍按实际用量结算。