快速开始

几步完成 NUWA API 的接入与调用。

核心要点

1）在 NUWA 控制台创建 sk-***； 2）SDK 或客户端里把 base_url 替换成 https://api.nuwaapi.com/v1； 3）在请求里填写要用的 model 即可切换不同模型。

一、获取访问凭证

1. 注册并登录 NUWA 控制台，进入 「API Key 管理」 生成密钥，形如 sk-****。
2. 建议按环境/项目区分多个 Key，并妥善保管。
3. 记录统一的 Base URL：https://api.nuwaapi.com/v1（国内可直连，无需代理）。

二、安装 SDK

Python

pip install openai --upgrade

TypeScript

npm install openai
# or
yarn add openai

三、首个请求示例

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-***",  # 换成你在 NUWA 生成的密钥
    base_url="https://api.nuwaapi.com/v1"
)

chat_completion = client.chat.completions.create(
    messages=[
        {
            "role": "user",
            "content": "Hello NUWA",
        }
    ],
    model="gpt-4o-mini",  # 替换为任意支持的模型 ID
)

print(chat_completion)

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-***",
  baseURL: "https://api.nuwaapi.com/v1",
});

async function main() {
  const resp = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "Hello, NUWA!" }],
  });

  console.log(resp.choices[0].message?.content);
}

main().catch(console.error);

Curl

curl --location 'https://api.nuwaapi.com/v1/chat/completions' \
  --header 'Authorization: Bearer sk-***' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello, NUWA!"}]
  }'

四、常用配置与排查

• 模型切换： 仅需更换请求体中的 model 值（如 gpt-4o-mini、claude-3-5-sonnet、gemini-2.0-flash-lite 等）。
• 超时与重试： 推理类大模型耗时较长，客户端可将超时设置为 30s+，并按需开启重试。
• 客户端地址填写： 部分第三方工具需输入完整路径 https://api.nuwaapi.com/v1 或 https://api.nuwaapi.com/v1/chat/completions。
• 网络： 国内可直连，如仍遇连接失败，可检查本地代理、DNS 或更换网络环境。
• Key 校验： 若返回未授权/401，请确认密钥是否包含前缀 sk-，且未过期或被撤销。

五、下一步

• 需要更多模型示例与调用方式，请查看 「NUWA一站式集成」。
• 音频、图片、视频、向量嵌入等能力，可在 「API文档」 目录下找到对应的示例与参数说明。