准备凭证
在控制台创建 API Key。Secret 只显示一次，请立即保存到密钥管理器。
- 确认账户或 Organization 有可用余额
- 从模型目录确认 alias：YOUR_MODEL_ALIAS
环境变量shell
export MOFANG_API_KEY="<your-api-key>"
export MOFANG_BASE_URL="https://cloudnode.skin/v1"发送请求
下面的命令直接调用当前配置的 Gateway。Idempotency-Key 可让一次业务动作在网络重试时保持唯一。
curlbash
curl "https://cloudnode.skin/v1/chat/completions" \
--request POST \
--header "Authorization: Bearer $MOFANG_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: quick-start-001" \
--data '{"max_completion_tokens": 256,"messages": [{"content": "请用一句话解释幂等性。","role": "user"}],"model": "YOUR_MODEL_ALIAS"}'成功响应json
{
"choices": [
{
"finish_reason": "stop",
"index": 0,
"message": {
"content": "...",
"role": "assistant"
}
}
],
"id": "chatcmpl-<request-id>",
"model": "YOUR_MODEL_ALIAS",
"object": "chat.completion",
"usage": {
"completion_tokens": 18,
"prompt_tokens": 12,
"total_tokens": 30
}
}