OpenAI-Compatible Gateway

Ion Clock Lab API 文档

一个简洁的 OpenAI-compatible API 网关，用来调用聊天模型、图像生成、Embeddings、文字转语音和语音转文字。

默认语言：English Base URL: https://llm.ionclocklab.com/v1 Gateway: LiteLLM

快速开始

每个请求都需要用户 API Key。请向管理员申请权限受限的 virtual key。不要在应用里使用 LiteLLM master key。

模型列表

打开模型列表

打开模型 JSON

Base URL

在 OpenAI-compatible SDK 或 HTTP 请求中使用这个基础地址：

https://llm.ionclocklab.com/v1

认证方式

在 Authorization header 中传入你的 key：

Authorization: Bearer YOUR_API_KEY

聊天补全

用于普通文字对话和 assistant 风格回复。

curl -X POST 'https://llm.ionclocklab.com/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Hello from Ion Clock Lab"}
    ]
  }'

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://llm.ionclocklab.com/v1",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "user", "content": "Hello from Ion Clock Lab"}
    ],
)

print(response.choices[0].message.content)

图像生成

用于生成图片。推荐模型： gpt-image-2

curl -sS -X POST 'https://llm.ionclocklab.com/v1/images/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean minimal logo for Ion Clock Lab",
    "n": 1,
    "size": "1024x1024"
  }' > /tmp/image_response.json

Embeddings

用于把文本转换成向量。推荐模型： text-embedding-3-small

curl -sS -X POST 'https://llm.ionclocklab.com/v1/embeddings' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Ion Clock Lab optical clock research"
  }'

文字转语音

用于从文本生成音频。推荐模型： tts-1

curl -sS -X POST 'https://llm.ionclocklab.com/v1/audio/speech' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "tts-1",
    "input": "Hello from Ion Clock Lab LiteLLM.",
    "voice": "alloy"
  }' --output /tmp/tts-test.mp3

语音转文字

用于把音频转写成文本。推荐模型： whisper-1, gpt-4o-mini-transcribe

curl -sS --location 'https://llm.ionclocklab.com/v1/audio/transcriptions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --form 'file=@"/tmp/tts-test.mp3"' \
  --form 'model="whisper-1"'

模型列表

公开模型列表页读取由 LiteLLM 模型注册表生成的静态 JSON。页面只展示模型名和类型，不暴露任何 API key。

推荐起始模型

用途	模型
聊天	gpt-4o-mini
聊天	gpt-4.1-mini
聊天	deepseek-chat
图像生成	gpt-image-2
Embedding	text-embedding-3-small
文字转语音	tts-1
语音转文字	whisper-1

常见错误

错误	常见原因	解决方法
401 Unauthorized	没有 API key，或者 key 写错了。	使用有效的 LiteLLM virtual key。
Model not found	key 没有权限使用该模型，或者模型没有注册。	检查模型列表和 key 权限。
Upstream provider error	上游 provider 拒绝了请求。	检查 provider key、模型名和请求格式。