跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ominiapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
补全 (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)

参数名类型必选说明
modelString是模型名称（例如 gpt-3.5-turbo-instruct 等）。
promptString / Array是生成文本的提示词，可以是单个字符串或字符串数组。
max_tokensInteger否生成补全文本的最大 Token 数量。
temperatureNumber否采样温度，控制生成内容的随机性。
top_pNumber否核采样参数（Nucleus sampling）。
nInteger否为每个提示生成的补全选项数量。
streamBoolean否是否启用流式输出（Server-Sent Events）。
stopString / Array否API 将停止生成后续 Token 的字符串序列（最多 4 个）。
suffixString否插入到生成文本末尾的后缀字符串。
echoBoolean否是否在补全的开头回显提示词 (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
    }
  }
}