跳转到主要内容
POST
https://api.aisa.one/v1
/
chat
/
completions
创建聊天补全
curl --request POST \
  --url https://api.aisa.one/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-4.1",
  "messages": [
    {
      "role": "user",
      "content": "<string>"
    }
  ],
  "stream": false,
  "logprobs": true,
  "top_logprobs": 123,
  "functions": [
    {
      "name": "<string>",
      "description": "<string>",
      "parameters": {}
    }
  ],
  "function_call": "auto"
}
'
import requests

url = "https://api.aisa.one/v1/chat/completions"

payload = {
    "model": "gpt-4.1",
    "messages": [
        {
            "role": "user",
            "content": "<string>"
        }
    ],
    "stream": False,
    "logprobs": True,
    "top_logprobs": 123,
    "functions": [
        {
            "name": "<string>",
            "description": "<string>",
            "parameters": {}
        }
    ],
    "function_call": "auto"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gpt-4.1',
    messages: [{role: 'user', content: '<string>'}],
    stream: false,
    logprobs: true,
    top_logprobs: 123,
    functions: [{name: '<string>', description: '<string>', parameters: {}}],
    function_call: 'auto'
  })
};

fetch('https://api.aisa.one/v1/chat/completions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/v1/chat/completions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gpt-4.1',
    'messages' => [
        [
                'role' => 'user',
                'content' => '<string>'
        ]
    ],
    'stream' => false,
    'logprobs' => true,
    'top_logprobs' => 123,
    'functions' => [
        [
                'name' => '<string>',
                'description' => '<string>',
                'parameters' => [
                                
                ]
        ]
    ],
    'function_call' => 'auto'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/v1/chat/completions"

	payload := strings.NewReader("{\n  \"model\": \"gpt-4.1\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"stream\": false,\n  \"logprobs\": true,\n  \"top_logprobs\": 123,\n  \"functions\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"parameters\": {}\n    }\n  ],\n  \"function_call\": \"auto\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.aisa.one/v1/chat/completions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gpt-4.1\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"stream\": false,\n  \"logprobs\": true,\n  \"top_logprobs\": 123,\n  \"functions\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"parameters\": {}\n    }\n  ],\n  \"function_call\": \"auto\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/v1/chat/completions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"gpt-4.1\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"stream\": false,\n  \"logprobs\": true,\n  \"top_logprobs\": 123,\n  \"functions\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"parameters\": {}\n    }\n  ],\n  \"function_call\": \"auto\"\n}"

response = http.request(request)
puts response.read_body
为给定的聊天对话创建模型响应。有关更多信息,请参阅 文本生成视觉音频指南。 支持的参数可能因用于生成响应的模型而异,尤其是较新的推理模型。下文会注明仅推理模型支持的参数。有关推理模型当前不支持的参数, 请参阅推理指南

流式响应

设置 "stream": true,即可在生成每个词元时接收服务器发送事件(SSE)。这可以缩短首词元响应时间,非常适合聊天界面。
curl https://api.aisa.one/v1/chat/completions \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "gpt-5",
    "messages": [{"role": "user", "content": "Write a haiku about APIs."}],
    "stream": true
  }'
from openai import OpenAI

client = OpenAI(base_url="https://api.aisa.one/v1", api_key="sk-aisa-...")

stream = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "Write a haiku about APIs."}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aisa.one/v1",
  apiKey: process.env.AISA_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Write a haiku about APIs." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

流的结构

SSE 流中的每一行如下所示:
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"Quiet"},"index":0}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":" packets"},"index":0}]}
...
data: {"id":"chatcmpl-...","choices":[{"delta":{},"finish_reason":"stop","index":0}]}
data: [DONE]
  • 每个 data: 行都是一个 JSON 对象。第一个数据块包含 role;后续数据块仅包含 delta.content
  • 流以设置了 finish_reason 的最终数据块结束,随后是字面量 data: [DONE] 行。
  • 如果使用工具调用,delta.tool_calls 会增量到达,应按 index 拼接。

处理错误和超时

  • 流中错误会作为普通 SSE 事件到达,其中包含 error 键而非 choices。请关闭流,并将错误返回给调用方。
  • 流断开(网络短暂故障、客户端超时)无法恢复,请重新发起请求。对于部分响应,不会收取超出已接收词元的费用。
  • 空闲超时:如果流超过 60 秒处于空闲状态(无词元),AIsa 会将其关闭。请将客户端读取超时设置为 120 秒,以留出安全余量。
  • 客户端背压:如果下游消费者处理缓慢,请停止从流中读取;AIsa 会限制传输速率,而不会丢弃词元。
流式与非流式采用相同的按词元费率。即使流在响应过程中被中断,已传输的词元仍会计费。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
string
示例:

"gpt-4.1"

messages
object[]
stream
boolean
示例:

false

logprobs
boolean
top_logprobs
integer
functions
object[]
function_call
示例:

"auto"

响应

200

成功完成