创建聊天补全
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聊天 API
OpenAI 聊天
创建聊天补全
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 会限制传输速率,而不会丢弃词元。
流式与非流式采用相同的按词元费率。即使流在响应过程中被中断,已传输的词元仍会计费。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
响应
200
成功完成
⌘I