创建文本补全

基于给定提示创建文本补全

POST /v1/completions

服务根地址: https://getrouter.ai

协议: OpenAI Completions

认证: Authorization: Bearer YOUR_API_KEY

请求体

请求体必填。 媒体类型: application/json

请求字段

字段类型必填说明
modelstring
promptstring or array<string>
max_tokensinteger
temperaturenumber
top_pnumber
ninteger
streamboolean
stopstring or array<string>
suffixstring
echoboolean

请求示例

curl --request POST \
  --url https://getrouter.ai/v1/completions \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "prompt": "一座未来城市的日落景象",
  "stream": false,
  "temperature": 1,
  "max_tokens": 1
}'

响应

状态码说明
200成功创建响应

成功响应字段

字段类型必填说明
idstring
objectstring
createdinteger
modelstring
choicesarray<object>
usageobject

响应示例

{
  "id": "string",
  "object": "object",
  "created": 1,
  "model": "MODEL_ID",
  "choices": [
    {
      "text": "string",
      "index": 1,
      "finish_reason": "string"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  }
}

此页面由公开 Relay OpenAPI 自动生成。完整规范可在 API Explorer 中查看。