Integration Guide - Node Global 文档中心

This service provides OpenAI-compatible AI model APIs. Tools that already use the OpenAI SDK or support the OpenAI protocol can connect by simply replacing the endpoint address and API Key.

Endpoint Address

Item	Value
Base URL	`https://t.ato2.nodesms.com/v1`
Protocol	HTTPS
Data format	JSON (`application/json`); image editing, audio transcription, and audio translation use `multipart/form-data` to upload files

Get an API Key

Log in to https://t.ato2.nodesms.com.
Go to the token management page and create a new token.
Copy the generated Key (starts with sk-).

An API Key is equivalent to your account password. Do not expose it in frontend code, public repositories, or client applications.

Authentication

All requests must include the API Key in the request header:

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Quick Test

curl https://t.ato2.nodesms.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Model names in the documentation are examples only. For actual available models, call the Models endpoint (GET /v1/models).

Use in the SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxx",
    base_url="https://t.ato2.nodesms.com/v1",
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxxxxxxxxxx",
  baseURL: "https://t.ato2.nodesms.com/v1",
});

In third-party clients (such as Cherry Studio, LobeChat, NextChat, etc.), select the OpenAI type and set the API address to https://t.ato2.nodesms.com (some clients require the full address with /v1).

Error Handling

When an API error occurs, it returns an OpenAI-compatible error structure:

{
  "error": {
    "message": "Error message",
    "type": "Error type",
    "param": null,
    "code": null
  }
}

Field	Type	Description
`message`	string	Error message
`type`	string	Error type
`param`	string or null	Related parameter
`code`	string or null	Error code

HTTP Status Code	Meaning	Suggested Action
`400`	Request parameter error	Check request body fields and format
`401`	Invalid or missing API Key	Check the `Authorization` header
`403`	No access to this model	Confirm the available model scope of the token
`404`	Resource does not exist	Check whether the path or task ID is correct
`429`	Rate limit exceeded or insufficient quota	Reduce frequency or retry after recharging
`500` / `502` / `503`	Server or upstream anomaly	Retry later

Each API documentation page has an API Playground embedded on the right. Fill in your API Key to debug APIs directly online.

API List

Models

GET /v1/models

Chat

ChatCompletions Format

POST /v1/chat/completions

Responses Format

POST /v1/responses

Text Completions

POST /v1/completions

Embeddings and Reranking

Embeddings

POST /v1/embeddings

Rerank

POST /v1/rerank

Images

Image Generation

POST /v1/images/generations

Image Editing

POST /v1/images/edits/

Audio

Audio Speech

POST /v1/audio/speech

Audio Transcription

POST /v1/audio/transcriptions

Audio Translation

POST /v1/audio/translations

Video

Create Video Generation Task

POST /v1/video/generations

Get Video Generation Task Status

GET /v1/video/generations/{task_id}

Moderation

POST /v1/moderations

​Endpoint Address

​Get an API Key

​Authentication

​Quick Test

​Use in the SDK

​Error Handling

​API List

​Models

Models

​Chat

ChatCompletions Format

Responses Format

Text Completions

​Embeddings and Reranking

Embeddings

Rerank

​Images

Image Generation

Image Editing

​Audio

Audio Speech

Audio Transcription

Audio Translation

​Video

Create Video Generation Task

Get Video Generation Task Status

​Moderation

Moderation

Endpoint Address

Get an API Key

Authentication

Quick Test

Use in the SDK

Error Handling

API List

Models

Chat

Embeddings and Reranking

Images

Audio

Video

Moderation