快速开始

功能概览

本页用于说明快速开始的核心能力、调用入口和接入要点，帮助开发者快速判断适用场景并完成集成。

适用场景

产品原型验证：快速接入模型能力，验证内容生成、理解或编辑流程。
生产业务接入：用于批量任务、自动化工作流和多模型组合调用。
能力迁移适配：适合从原有模型或 SDK 平滑切换到亿速云AI统一接口。

接入建议

优先确认模型名称、请求路径和响应字段，再接入具体业务流程。
对异步任务、媒体生成和长耗时请求，建议在业务侧加入重试与状态轮询。
上线前建议准备日志追踪、错误兜底和内容安全校验，便于稳定运行。

第一步：账户准备

1.1 注册账号

访问亿速云AI官网注册账号：

使用邮箱注册（推荐高校、企业邮箱注册）
验证邮箱地址
登录控制台

第二步：创建 API 密钥

2.1 生成密钥

在后台导航点击"令牌"栏目，https://xxx.yisu.com/token
可以复制【默认令牌】直接使用（右侧有个复制图标）
或者新创建令牌：点击右上侧"新增"按钮，为密钥命名（如：test-key），点击确认创建，即拥有新的令牌。

第三步：开始调用

3.1 获取接入信息

API 地址（所谓的 Base_Url）：https://xxx.yisu.com
API 密钥：您刚创建的密钥
请求格式：完全兼容 OpenAI API，兼容 OpenAI 格式调用。

3.2 测试调用

使用 curl 快速测试：

curl https://xxx.yisu.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

3.3 代码示例

Python

    from openai import OpenAI

    client = OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://xxx.yisu.com/v1"
    )

    response = client.chat.completions.create(
        model="gpt-4.1-mini",
        messages=[
            {"role": "user", "content": "Hello!"}
        ]
    )

    print(response.choices[0].message.content)

Node.js

    import OpenAI from 'openai';

    const openai = new OpenAI({
      apiKey: 'YOUR_API_KEY',
      baseURL: 'https://xxx.yisu.com/v1'
    });

    const response = await openai.chat.completions.create({
      model: 'gpt-4.1-mini',
      messages: [{ role: 'user', content: 'Hello!' }]
    });

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

Java

    // 使用官方 OpenAI Java 库
    OpenAiService service = new OpenAiService(
        "YOUR_API_KEY", 
        Duration.ofSeconds(60), 
        "https://xxx.yisu.com/v1"
    );

    ChatCompletionRequest request = ChatCompletionRequest.builder
        .model("gpt-4.1-mini")
        .messages(List.of(
            new ChatMessage(ChatMessageRole.USER, "Hello!")
        ))
        .build;

    ChatCompletionResult result = service.createChatCompletion(request);
    System.out.println(result.getChoices.get(0).getMessage.getContent);

下一步

恭喜！您已经成功完成了亿速云AI 的接入。接下来您可以：

查看 API 文档

了解完整的 API 接口说明

探索模型列表

查看所有支持的 AI 模型

集成到应用

将亿速云AI 集成到各种工具

查看使用统计

在控制台监控使用情况

常见问题

如何切换模型？

只需修改请求中的 model 参数：

{
  "model": "gpt-4.1",           // 使用 GPT-4.1
  "model": "claude-sonnet-4-20250514",   // 使用 Claude 4 Sonnet
  "model": "gemini-2.5-pro"       // 使用 Gemini 2.5 Pro
}

支持哪些编程语言？

亿速云AI 兼容 OpenAI API 标准，支持所有 OpenAI SDK 支持的语言：

Python
JavaScript/TypeScript
Java
C#/.NET
Go
Ruby
PHP
更多...

遇到问题怎么办？

查看 API 文档
检查常见错误

模型以实际为准、文档只作为参考，请根据实际使用情况选择模型。