建立文字完成

根據指定的提示詞建立文字完成

POST /v1/completions

服務根位址: https://getrouter.ai

通訊協定: OpenAI Completions

驗證: Authorization: Bearer YOUR_API_KEY

請求主體

請求主體為必填。媒體類型: application/json

請求欄位

欄位	型別	必填	說明
`model`	`string`	是	—
`prompt`	`string or array<string>`	是	—
`max_tokens`	`integer`	否	—
`temperature`	`number`	否	—
`top_p`	`number`	否	—
`n`	`integer`	否	—
`stream`	`boolean`	否	—
`stop`	`string or array<string>`	否	—
`suffix`	`string`	否	—
`echo`	`boolean`	否	—

請求範例

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`	已成功建立回應

成功回應欄位

欄位	型別	必填	說明
`id`	`string`	否	—
`object`	`string`	否	—
`created`	`integer`	否	—
`model`	`string`	否	—
`choices`	`array<object>`	否	—
`usage`	`object`	否	—

回應範例

{
  "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。

#建立文字完成

#請求主體

#請求欄位

#請求範例

#回應

#成功回應欄位

#回應範例