补全 (Completions) - 原生 OpenAI 格式

基于给定提示 (prompt) 创建文本补全。完全兼容 OpenAI 的 Completions API 格式。

接口地址: POST /v1/completions
请求格式 (Content-Type): application/json

认证与请求头 (Headers)

Authorization (必选): 使用 Bearer Token 认证。格式: Bearer <token> 或 Bearer sk-xxxxxx

请求参数 (Request Body - JSON)

参数名	类型	必选	说明
`model`	String	是	模型名称（例如 `gpt-3.5-turbo-instruct` 等）。
`prompt`	String / Array	是	生成文本的提示词，可以是单个字符串或字符串数组。
`max_tokens`	Integer	否	生成补全文本的最大 Token 数量。
`temperature`	Number	否	采样温度，控制生成内容的随机性。
`top_p`	Number	否	核采样参数（Nucleus sampling）。
`n`	Integer	否	为每个提示生成的补全选项数量。
`stream`	Boolean	否	是否启用流式输出（Server-Sent Events）。
`stop`	String / Array	否	API 将停止生成后续 Token 的字符串序列（最多 4 个）。
`suffix`	String	否	插入到生成文本末尾的后缀字符串。
`echo`	Boolean	否	是否在补全的开头回显提示词 (prompt)。

示例代码 (cURL)

curl -X POST "[https://www.ominiapi.com/v1/completions](https://www.ominiapi.com/v1/completions)" \
  -H "Authorization: Bearer <您的_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo-instruct",
    "prompt": "Say this is a test",
    "max_tokens": 7,
    "temperature": 0
  }'

响应体结构 (Response - 200 OK)

成功请求将返回 JSON 格式结果。

{
  "id": "cmpl-uqkvlQyYK7bGYrRHQ0eXlWiTgIRlc",
  "object": "text_completion",
  "created": 1589478378,
  "model": "gpt-3.5-turbo-instruct",
  "choices": [
    {
      "text": "\n\nThis is indeed a test",
      "index": 0,
      "finish_reason": "length"
    }
  ],
  "usage": {
    "prompt_tokens": 5,
    "completion_tokens": 7,
    "total_tokens": 12,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 5,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 7,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    }
  }
}