Skip to content

Endpoints

Tianshu offers two routes — just pick one based on the type of request.

Standard route (default)

https://tian-shu.org

Suitable for the vast majority of endpoints: chat, text, embeddings, rerank, and so on. Streaming chat output starts returning tokens as soon as the connection is established and is not affected by first-byte timeouts, so this route is recommended by default.

Direct route (long requests / image generation)

https://api.tian-shu.org

Suitable for long-running requests that return all at once, typically image generation (/v1/images/generations etc.). These requests only return their result after the server finishes computing, which can easily trigger CDN request timeouts; the direct route bypasses the CDN and reaches the origin directly, avoiding timeout interruptions.

Rule of thumb: streaming requests that keep emitting tokens → standard route; requests that compute for a long time and then return all at once (image generation, etc.) → direct route.

Endpoint paths

Both routes are compatible with OpenAI-style paths, for example:

UsePath
Chat completions/v1/chat/completions
Responses/v1/responses
Claude Messages/v1/messages
Embeddings/v1/embeddings
Rerank/v1/rerank
Image generation/v1/images/generations
Speech / transcription/v1/audio/speech, /v1/audio/transcriptions

Which endpoints a specific model supports is determined by what's noted on the Model Marketplace.