Skip to content

完成第一次 iDreame API 对话调用

目标

从环境变量读取 API 令牌,先查询当前可用模型,再完成一次非流式对话请求。

前置条件

  1. 登录 iDreame 控制台并创建令牌。
  2. 确认账户状态和余额可用。
  3. 本机已安装 curl

步骤

把令牌放进当前终端的环境变量。不要把真实令牌写进教程、代码仓库或浏览器前端:

bash
export IDREAME_API_KEY="替换为你的令牌"

先查询模型列表,并从响应中选择一个当前可用的模型 ID:

bash
curl https://api.idreame.ai/v1/models \
  -H "Authorization: Bearer $IDREAME_API_KEY"

把选中的 ID 写入另一个环境变量,再发送对话请求:

bash
export IDREAME_MODEL_ID="替换为模型列表中的 ID"

curl https://api.idreame.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $IDREAME_API_KEY" \
  -d "{\"model\":\"$IDREAME_MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"请用一句话介绍你能做什么。\"}]}"

预期结果

模型列表请求返回当前可用的模型;对话请求返回 JSON,其中 choices[0].message.content 包含回复内容。

排错

  • 返回 401:检查令牌是否完整、有效,并确认请求头使用 Bearer
  • 返回 model_not_found:重新请求模型列表,使用响应中的真实 ID。
  • 返回 429:降低请求频率,并按 API 概览建议使用指数退避。
  • 其他错误:查看错误码并记录响应中的错误信息。

基于 OpenAI 兼容协议 · 多模态算力网关