NectarAI 开发文档

1. 快速开始

获取你的 API-Key（控制台右上角），替换下方 YOUR_API_KEY 即可测试：

# 最简调用（非流式）

curl -sS "https://open.5a.gs/api/v1/chat/completions" \

  -H 'Content-Type: application/json' \

  -H 'Authorization: Bearer YOUR_API_KEY' \

  -d '{
    "model": "NectarAI/Nectar-9B",
    "messages": [{"role": "user", "content": "用中文回答：今天北京天气如何？"}],
    "temperature": 0.7,
    "stream": false
  }'
        

返回示例：

{
  "id": "chatcmpl-xxx",

  "object": "chat.completion",

  "created": 1704067200,

  "model": "NectarAI/Nectar-9B",

  "choices": [{

    "index": 0,

    "message": {

      "role": "assistant",

      "content": "北京今天晴，气温 22~30 ℃，南风 2 级……"

    },

    "finish_reason": "stop"

  }],

  "usage": {

    "prompt_tokens": 22,

    "completion_tokens": 38,

    "total_tokens": 60

  }

}

2. 接口总览

端点	方法	描述
`/api/v1/chat/completions`	POST	聊天完成（支持流式、视觉、深度思考）
`/api/v1/completions`	POST	文本补全（OpenAI 旧版兼容）
`/api/v1/models`	GET	列出可用模型
`/api/v1/models/{model_id}`	GET	获取模型详情
`/api/v1/usage`	GET	个人用量与余额

3. 通用请求格式

Base URL：https://open.5a.gs
鉴权方式：Bearer Token（放在 Header Authorization）
请求体：JSON，UTF-8 编码
返回体：统一 JSON，含 error 字段即表示失败

4. 聊天完成 `POST /api/v1/chat/completions`

① 请求体（基础文本）

{
  "model": "NectarAI/Nectar-9B",

  "messages": [

    {"role": "system", "content": "你是智能助手"},

    {"role": "user",   "content": "1+1"}

  ],

  "max_tokens":  4096,

  "temperature": 0.7,

  "stream": false
}

② 视觉/多模态请求 (Vision)

支持上传图片 URL 进行多模态对话（需使用支持视觉的模型，如 Nectar-9B）。

{
  "model": "NectarAI/Nectar-9B",

  "messages": [

    {

      "role": "user",

      "content": [

        {"type": "text", "text": "这张图片里有什么？"},

        {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}

      ]

    }

  ]

}

③ 流式响应（SSE）

将 "stream":true 即可，返回标准 text/event-stream，每段格式：

data: { "choices":[{ "delta":{"content":"xxx"} }] }

结束标志：

data: [DONE]

5. 计费标准

模型	单价（CNY/1k tokens）	最大 tokens	特性
`NectarAI/Nectar-9B`	¥0.01	4 096	视觉理解、深度思考
`NectarAI/Nectar-7B`	¥0.01	4 096	通用对话
`NectarAI/Nectar-V3`	¥0.01	4 096	-
`NectarAI/Nectar-Coder-Plus`	¥0.01	8 192	代码增强
`NectarAI/Nectar-K2-0905`	¥0.01	8 192	-
`NectarAI/Nectar-K2`	¥0.01	8 192	-

计费公式：cost = total_tokens × 0.01 / 1000
余额不足时返回 HTTP 402 insufficient_funds。

6. 错误码速查

HTTP	code	说明
401	invalid_api_key	API-Key 无效或账号被禁用
402	insufficient_funds	余额不足
400	missing_messages	缺少 messages 字段
405	method_not_allowed	HTTP 方法不被允许
502	upstream_error	上游 SiliconFlow 异常

7. PHP 调用示例

<?php

$apiKey = 'YOUR_API_KEY';

$host   = 'https://open.5a.gs';

$payload = [

  'model'    => 'NectarAI/Nectar-9B',

  'messages' => [['role' => 'user', 'content' => '用中文回答：什么是人工智能？'],

  'temperature' => 0.7,

  'stream' => false

];

$ch = curl_init($host.'/api/v1/chat/completions');

curl_setopt_array($ch, [

  CURLOPT_POST           => true,

  CURLOPT_HTTPHEADER     => [

    'Content-Type: application/json',

    'Authorization: Bearer '.$apiKey

  ],

  CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),

  CURLOPT_RETURNTRANSFER => true,

  CURLOPT_SSL_VERIFYPEER => true

]);

$response = curl_exec($ch);

curl_close($ch);

$data = json_decode($response, true);

echo $data['choices'][0]['message']['content'] ?? '生成失败';

?>

8. 常见问答

Q：支持 GPT-4 或 Claude 吗？
A：目前主力模型为 NectarAI/Nectar-9B（支持视觉与深度思考），性能媲美主流中杯模型。
Q：如何使用视觉/图片理解？
A：使用 Nectar-9B 模型，并在 messages 中传入 image_url 类型的 content。
Q：什么是深度思考 (Thinking)？
A：Nectar-9B 模型内置思维链能力，会自动对复杂问题进行深度推理，无需额外参数。
Q：token 怎么估算？
A：系统内置多模态估算算法，文本中文≈2字符/token，图片固定 1000 tokens/张。
Q：余额不足会怎样？
A：接口直接返回 HTTP 402，不消耗任何 token。

9. 更新日志

日期	版本	说明
2026-01-25	v1.1.0	新增 Nectar-9B 模型，支持视觉理解（Vision）与深度思考（Thinking）
2025-12-17	v1.0.0	初版上线，支持 chat/completions、completions、models、usage 端点