NeonAPI Docs

POST /v1/responses

身分驗證

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

可用性與相容性

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

請求參數

application/json

欄位	類型	必填	限制	意義
`model`	`string`	是	—	模型廣場發布的準確 ID。
`input`	`string / object[]`	否	—	按目前端點格式提供輸入內容。
`instructions`	`string`	否	—	—
`max_output_tokens`	`integer`	否	—	—
`temperature`	`number`	否	—	模型支援時使用的取樣溫度。
`top_p`	`number`	否	—	核取樣機率。
`stream`	`boolean`	否	—	請求增量串流事件。
`tools`	`object[]`	否	—	由應用提供的工具定義。
`tool_choice`	`string / object`	否	—	控制工具的選擇方式。
`reasoning`	`object`	否	—	—
`previous_response_id`	`string`	否	—	—
`truncation`	`string`	否	`auto`, `disabled`	—

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

請求範例

export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1/responses \
  -H "Authorization: Bearer $NEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "YOUR_MODEL_ID",
  "input": "Hello"
}'

回應說明

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

狀態碼	意義
200	請求成功

回應結構

欄位	類型	必填	限制	意義
`id`	`string`	否	—	該結果或任務的識別碼。
`object`	`string`	否	—	—
`created_at`	`integer`	否	—	—
`status`	`string`	否	`completed`, `failed`, `in_progress`, `incomplete`	目前非同步任務狀態。
`model`	`string`	否	—	模型廣場發布的準確 ID。
`output`	`object[]`	否	—	產生的回應項目。
`usage`	`Usage`	否	—	目前協定回傳的用量資料。

下載使用者 OpenAPI 規格

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

Responses 回應