TArk 元舟

快速开始

使用 OpenAI 兼容方式完成第一次 TArk API 调用。

准备工作

  1. 在 tarkcloud.com 注册并登录账号。

  2. 登录后,进入个人中心完成实名认证。

    个人中心实名认证入口

  3. 如需充值使用额度,前往 财务中心 / 钱包 为账户余额充值。

  4. 进入 API 密钥 页面,点击 创建密钥。

    创建 API 密钥

  5. 设置密钥名称、额度和过期时间,然后点击确认。

    配置 API 密钥

  6. 创建成功后,立即复制 API Key 并保存到安全位置。

    复制新建的 API 密钥

API Key 具备调用权限。请使用环境变量或密钥管理器保存,不要写入前端代码、公开仓库或客户端安装包。

已创建的密钥可在 API 密钥列表中确认状态,或按需要编辑额度、有效期等配置。

管理 API 密钥

发送第一个请求

TArk API 遵循 OpenAI API 的常用请求和响应格式。您可以通过更改 base URL 和 API 密钥,使用标准 HTTP 请求或兼容 OpenAI 的 SDK 接入。

使用 OpenAI SDK (Node.js)

首先,安装官方的 OpenAI SDK:

npm install openai

然后,配置 TArk 的请求地址:

TypeScript
import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://www.tarkcloud.com/v1',
  apiKey: process.env.TARK_API_KEY,
});

const completion = await openai.chat.completions.create({
  model: 'deepseek/deepseek-chat-v3',
  messages: [
    { role: 'user', content: '你好,你能做什么?' }
  ],
});

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

model 需要填写模型页面或控制台中展示的模型标识。不同模型支持的上下文长度、输入输出类型和价格可能不同。

直接使用 cURL

您也可以使用 HTTP API,支持任何编程语言:

cURL
curl https://www.tarkcloud.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TARK_API_KEY" \
  -d '{
    "model": "deepseek/deepseek-chat-v3",
    "messages": [
      {"role": "user", "content": "你好!"}
    ]
  }'

下一步

On this page