回線の説明

天枢は 2 つの接続回線を提供しており、リクエストの種類に応じて選べばよいだけです。

標準回線(デフォルト)

https://tian-shu.org

ほとんどのインターフェースに適しています:チャット、テキスト、ベクトル(embeddings)、リランク(rerank)など。チャットのストリーミング出力は接続確立後すぐにトークンの返却を開始し、初回バイトのタイムアウトの影響を受けません。デフォルトで利用することをおすすめします。

直結回線(長時間リクエスト / 画像生成)

https://api.tian-shu.org

長時間かかり、一度にまとめて返ってくるリクエストに適しています。典型的には画像生成(/v1/images/generations など)です。この種のリクエストはサーバー側で計算が完了してから一括で結果を返すため、CDN のリクエストタイムアウトを引き起こしやすくなります。直結回線は CDN を迂回してオリジンサーバーへ直接到達し、タイムアウトによる中断を回避します。

経験則:継続的にトークンを吐き出すストリーミングリクエスト → 標準回線;長く計算してから一括で返ってくるリクエスト(画像生成など) → 直結回線。

インターフェースのパス

どちらの回線も OpenAI スタイルのパスに対応しています。例えば:

用途	パス
対話補完	/v1/chat/completions
Responses	/v1/responses
Claude Messages	/v1/messages
ベクトル	/v1/embeddings
リランク	/v1/rerank
画像生成	/v1/images/generations
音声合成 / 文字起こし	/v1/audio/speech、/v1/audio/transcriptions

特定のモデルがどのインターフェースに対応しているかは、モデル広場 の表記を基準とします。