舊版文字補全

POST /v1/completions

身分驗證

將 NeonAPI 金鑰放入 Authorization: Bearer YOUR_API_KEY 請求標頭，在可信應用環境中保管金鑰。

可用性與相容性

呼叫前核對模型的協定、權限、報價與支援參數。不支援的參數可能被拒絕。範例中的金鑰與模型均為佔位符。

請求參數

application/json

欄位	類型	必填	限制	意義
`model`	`string`	是	—	模型廣場發布的準確 ID。
`prompt`	`string / string[]`	是	—	指令或生成提示詞。
`max_tokens`	`integer`	否	—	輸出 token 上限，取決於模型。
`temperature`	`number`	否	—	模型支援時使用的取樣溫度。
`top_p`	`number`	否	—	核取樣機率。
`n`	`integer`	否	—	生成結果數量，受模型限制。
`stream`	`boolean`	否	—	請求增量串流事件。
`stop`	`string / string[]`	否	—	—
`suffix`	`string`	否	—	—
`echo`	`boolean`	否	—	—

完整欄位定義、巢狀物件和引用結構可在下載的規格中查看。

請求範例

export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1/completions \
  -H "Authorization: Bearer $NEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "YOUR_MODEL_ID",
  "prompt": "A quiet constellation above a midnight observatory"
}'

回應說明

實際欄位因模型與協定而異。下方結構描述文件中的成功回應；串流請求使用對應協定的事件。

狀態碼	意義
200	請求成功

回應結構

欄位	類型	必填	限制	意義
`id`	`string`	否	—	該結果或任務的識別碼。
`object`	`string`	否	—	—
`created`	`integer`	否	—	—
`model`	`string`	否	—	模型廣場發布的準確 ID。
`choices`	`object[]`	否	—	產生的補全候選結果。
`usage`	`Usage`	否	—	目前協定回傳的用量資料。

下載使用者 OpenAPI 規格

另見常見錯誤與串流回應和非同步任務。