易算云文档中心

Appearance

首次调用易算 API ​

易算云提供文本对话、推理、视觉理解、向量嵌入及语音等 AI 能力，API 兼容 OpenAI 与 Anthropic 接口规范，支持流式与非流式调用。

本文引导您完成易算 API 的首次调用，分为四步：了解接口的基本信息、获取 API Key、发起请求、查看响应。

接口基本信息 ​

项目说明
API 网关地址https://dashscope.yeesuan.com/v1
OpenAI 兼容Authorization: Bearer <API Key>，端点 POST /v1/chat/completions
Anthropic 兼容x-api-key: <API Key> + anthropic-version: 2023-06-01，端点 POST /v1/messages
API Key在平台「Token 管理」创建，格式为 <API Key>

两种协议共享同一 Base URL，通过请求头和端点区分。

第一步：获取 API Key ​

  1. 登录易算平台控制台。
  2. 点击「Token Plan」按钮，进入页面，点击「API Keys」，创建 API Key。
  3. 创建后复制生成的密钥，格式为 <API Key>。

请妥善保管 API Key，请勿泄露或提交到公开代码仓库。

第二步：查看可用模型 ​

调用模型列表接口，获取当前账户可用的模型。

OpenAI 协议 ​

bash
curl https://dashscope.yeesuan.com/v1/models \
  -H "Authorization: Bearer <API Key>"

Anthropic 协议 ​

bash
curl https://dashscope.yeesuan.com/v1/models \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: <API Key>"

返回结果中 data[].id 即为可用的模型名称。

第三步：发起请求 ​

OpenAI 协议 ​

易算云 API 兼容 OpenAI 接口规范，只需替换 base_url、api_key、model 即可。点击下方标签可切换不同编程语言的示例。

bash
curl https://dashscope.yeesuan.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API Key>" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    "stream": false,
    "max_tokens": 1024,
    "temperature": 0.7
  }'
python
# pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="<API Key>",
    base_url="https://dashscope.yeesuan.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "你是一个有用的助手"},
        {"role": "user", "content": "你好，请介绍一下你自己"},
    ],
    stream=False,
    max_tokens=1024,
    temperature=0.7,
)

print(resp.choices[0].message.content)
go
package main

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

func main() {
    url := "https://dashscope.yeesuan.com/v1/chat/completions"
    payload := strings.NewReader(`{
        "model": "deepseek-chat",
        "messages": [
            {"role": "system", "content": "你是一个有用的助手"},
            {"role": "user", "content": "你好，请介绍一下你自己"}
        ],
        "stream": false,
        "max_tokens": 1024,
        "temperature": 0.7
    }`)

    req, _ := http.NewRequest("POST", url, payload)
    req.Header.Add("Content-Type", "application/json")
    req.Header.Add("Authorization", "Bearer <API Key>")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}
javascript
// npm install openai

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "<API Key>",
    baseURL: "https://dashscope.yeesuan.com/v1",
});

const completion = await client.chat.completions.create({
    model: "deepseek-chat",
    messages: [
        { role: "system", content: "你是一个有用的助手" },
        { role: "user", content: "你好，请介绍一下你自己" },
    ],
    stream: false,
    max_tokens: 1024,
    temperature: 0.7,
});

console.log(completion.choices[0].message.content);

Anthropic 协议 ​

bash
curl https://dashscope.yeesuan.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: <API Key>" \
  -d '{
    "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}],
    "model": "deepseek-chat",
    "max_tokens": 1024,
    "stream": false
  }'
python
# pip install anthropic

import anthropic

client = anthropic.Anthropic(
    base_url="https://dashscope.yeesuan.com/v1",
    api_key="<API Key>",
)

message = client.messages.create(
    model="deepseek-chat",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，请介绍一下你自己"}],
)

print(message.content[0].text)
go
package main

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

func main() {
    url := "https://dashscope.yeesuan.com/v1/messages"
    payload := strings.NewReader(`{
        "model": "deepseek-chat",
        "max_tokens": 1024,
        "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}]
    }`)

    req, _ := http.NewRequest("POST", url, payload)
    req.Header.Add("Content-Type", "application/json")
    req.Header.Add("anthropic-version", "2023-06-01")
    req.Header.Add("x-api-key", "<API Key>")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}
javascript
// npm install @anthropic-ai/sdk

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
    apiKey: "<API Key>",
    baseURL: "https://dashscope.yeesuan.com/v1",
});

const message = await client.messages.create({
    model: "deepseek-chat",
    max_tokens: 1024,
    messages: [{ role: "user", content: "你好，请介绍一下你自己" }],
});

console.log(message.content[0].text);

第四步：查看响应 ​

OpenAI 响应格式 ​

非流式调用返回标准的 OpenAI 格式，核心字段如下：

字段说明
choices[].message.content模型生成的回复内容
choices[].finish_reason结束原因（stop / length / tool_calls 等）
usage.prompt_tokens输入 token 数
usage.completion_tokens输出 token 数
usage.total_tokens总 token 数

Anthropic 响应格式 ​

核心字段如下：

字段说明
content[].text模型生成的文本回复
content[].type内容类型（text / thinking）
stop_reason结束原因（end_turn / max_tokens 等）
usage.input_tokens输入 token 数
usage.output_tokens输出 token 数

流式调用 ​

OpenAI 协议 ​

将 stream 设为 true：

bash
curl https://dashscope.yeesuan.com/v1/chat/completions \
  -H "Authorization: Bearer <API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

流式响应按 data: {...} 的 SSE 格式分批返回，以 data: [DONE] 结束。

Anthropic 协议 ​

bash
curl https://dashscope.yeesuan.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: <API Key>" \
  -d '{
    "messages": [{"role": "user", "content": "你好"}],
    "model": "deepseek-chat",
    "max_tokens": 1024,
    "stream": true
  }'

流式响应按 event: ... 的 SSE 格式分批返回。

常见问题 ​

状态码说明解决方法
401API Key 无效或未正确携带检查 API Key 是否正确，确认请求头中已携带
404模型不存在确认模型名称正确、账户有权限使用该模型
429触发限流或额度不足稍后重试或升级套餐

更多模型选择与计费详情，请参考《选择模型》和《计费说明》。