# Bearer Token（推荐）
curl https://api.alice.fans/api/v1/models \
  -H "Authorization: Bearer miyang-xxx"

# x-api-key（备用）
curl https://api.alice.fans/api/v1/models \
  -H "x-api-key: miyang-xxx"

# 自动选择适合当前请求的模型
model = "miyang/auto"

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": 1002
  }
}

// 余额不足响应（402）
{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 1004
  }
}

curl https://api.alice.fans/api/v1/chat/completions \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang/auto",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'

curl https://api.alice.fans/api/v1/chat/completions \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang/miyang-omni-v1",
    "reasoning_effort": "none",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "按時間順序轉寫並摘要這段錄音。"},
        {"type": "input_audio", "input_audio": {
          "data": "https://example.com/meeting.mp3",
          "format": "mp3"
        }}
      ]
    }],
    "stream": false
  }'

{
  "object": "list",
  "data": [
    {
      "id": "miyang/auto",
      "object": "model",
      "owned_by": "miyang",
      "name": "自动",
      "model_type": "text",
      "usage_scope": "alice",
      "usage_hint": "请在 Alice 客户端内使用",
      "context_length": 262144
    }
  ]
}

curl https://api.alice.fans/api/v1/pricing \
  -H "Authorization: Bearer miyang-xxx"

{
  "object": "pricing.list",
  "mili_per_usd": 1000,
  "data": [
    {
      "id": "miyang/auto",
      "model_type": "text",
      "currency": "USD",
      "billing_mode": "tokens",
      "billing_unit": "per_1m_tokens",
      "effective_pricing": "<base | peak | promotion>",
      "rates": {
        "input": "<current rate>",
        "output": "<current rate>",
        "cache_read": "<current rate>",
        "cache_write": "<current rate>"
      }
    }
  ]
}

curl https://api.alice.fans/api/v1/embeddings \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "provider/embedding-model",
    "input": "需要向量化的文本"
  }'

curl https://api.alice.fans/api/v1/decisions \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang/jev-1.13",
    "state": {"dialog": "用戶問了一個普通技術問題"},
    "questions": {
      "remember": {
        "type": "noul",
        "instructions": "這段對話是否包含值得長期保存的資訊？",
        "criteria": {
          "true": "包含穩定身份、長期偏好或明確關係事件",
          "false": "一次性任務、普通問答或寒暄"
        }
      }
    }
  }'

{
  "model": "miyang/jev-1.13",
  "provider": "miyang",
  "answers": {
    "remember": {
      "type": "noul",
      "noul": 0.02
    }
  }
}

curl https://api.alice.fans/api/v1/images/generations \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ts/gpt-image-2",
    "prompt": "A children'\''s book drawing of a veterinarian listening to the heartbeat of a baby otter",
    "size": "1024x1024",
    "quality": "high"
  }'

from openai import OpenAI
import base64

client = OpenAI(
    api_key="miyang-xxx",
    base_url="https://api.alice.fans/api/v1",
    timeout=180.0,  # 图像生成需要较长超时
)

result = client.images.generate(
    model="ts/gpt-image-2",
    prompt="A children's book drawing of a veterinarian listening to the heartbeat of a baby otter",
    size="1024x1024",
    quality="high",
)
print(result.data[0].url)

import httpx, json, base64

resp = httpx.post(
    "https://api.alice.fans/api/v1/images/generations",
    headers={"Authorization": "Bearer miyang-xxx"},
    json={
        "model": "ts/gpt-image-2",
        "prompt": "A serene Japanese garden with a koi pond",
        "size": "1536x1024",
        "quality": "medium",
        "output_format": "jpeg",       # jpeg 比 png 更快
        "output_compression": 80,     # 压缩率 0-100
    },
    timeout=180.0,
)
data = resp.json()
print(data["data"][0]["url"])

// 响应示例
{
  "created": 1779691963,
  "data": [
    {
      "url": "https://image.token-recyclebin.com/images/2026/05/25/xxx.png",
      "revised_prompt": "A serene Japanese garden with a koi pond..."
    }
  ]
}

curl https://api.alice.fans/api/v1/images/edits \
  -H "Authorization: Bearer miyang-xxx" \
  -F "model=ts/gpt-image-2" \
  -F "prompt=Turn this photo into a Studio Ghibli style illustration" \
  -F "image=@photo.png" \
  -F "size=1536x1024"

from openai import OpenAI

client = OpenAI(
    api_key="miyang-xxx",
    base_url="https://api.alice.fans/api/v1",
    timeout=180.0,
)

result = client.images.edit(
    model="ts/gpt-image-2",
    image=open("photo.png", "rb"),
    prompt="Turn this photo into a Studio Ghibli style illustration",
)
print(result.data[0].url)

# 多图参考：用 image[] 传多张
curl https://api.alice.fans/api/v1/images/edits \
  -H "Authorization: Bearer miyang-xxx" \
  -F "model=ts/gpt-image-2" \
  -F "image[]=@lotion.png" \
  -F "image[]=@soap.png" \
  -F "image[]=@candle.png" \
  -F 'prompt=A gift basket on a white background containing all these items'

# mask 需要有 alpha 通道，透明区域为编辑区
result = client.images.edit(
    model="ts/gpt-image-2",
    image=open("room.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="Add a flamingo in the pool area",
    quality="high",
)
print(result.data[0].url)

curl https://lab.miyang.cn/ripple/api/v1/jobs \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Idempotency-Key: restore-order-001" \
  -F "image=@photo.png" \
  -F "allow_regen=true" \
  -F "max_regen=2"

{
  "id": "rp-api-...",
  "object": "ripple.job",
  "status": "queued",
  "phase": "queued",
  "result": null,
  "error": null
}

curl https://lab.miyang.cn/ripple/api/v1/jobs/rp-api-... \
  -H "Authorization: Bearer miyang-xxx"

{
  "id": "rp-api-...",
  "status": "succeeded",
  "result": {
    "outcome": "delivered",
    "regen_rounds": 1,
    "artifacts": [
      {
        "name": "photo_restored.png",
        "primary": true,
        "url": "https://lab.miyang.cn/ripple/api/v1/jobs/rp-api-.../artifacts/photo_restored.png"
      }
    ]
  },
  "error": null
}

curl https://api.alice.fans/api/v1/videos/generations \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Idempotency-Key: alice-video-001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang/h3",
    "content": [
      {"type": "text", "text": "A lamb runs across a sunlit meadow"}
    ],
    "duration": 5,
    "resolution": "768P",
    "ratio": "16:9"
  }'

{
  "task_id": "443429054845209"
}

curl https://api.alice.fans/api/v1/videos/generations/443429054845209 \
  -H "Authorization: Bearer miyang-xxx"

{
  "task": {
    "status": "succeeded",
    "resolution": "768P",
    "duration": 5,
    "content": {
      "url": "https://signed.example/video.mp4",
      "drive_file_id": "drv-xxx",
      "size_bytes": 1757278,
      "expires_in": 3600
    }
  }
}

curl -X DELETE https://api.alice.fans/api/v1/videos/generations/443429054845209 \
  -H "Authorization: Bearer miyang-xxx"

curl https://api.alice.fans/api/v1/audio/transcriptions \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Idempotency-Key: meeting-20260921" \
  -F "model=miyang-asr" \
  -F "source_language=cn" \
  -F "diarization=true" \
  -F "file=@meeting.m4a"

curl https://api.alice.fans/api/v1/audio/transcriptions \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Idempotency-Key: archive-001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang-asr",
    "file_url": "https://example.com/recording.mp3",
    "source_language": "multilingual",
    "language_hints": ["cn", "en"]
  }'

{
  "id": "6f3a...task",
  "object": "audio.transcription.job",
  "status": "processing",
  "model": "miyang/miyang-asr",
  "request_id": "3d7e...request",
  "source_file_id": "drv-..."
}

curl https://api.alice.fans/api/v1/audio/transcriptions/6f3a...task \
  -H "Authorization: Bearer miyang-xxx"

{
  "id": "6f3a...task",
  "object": "audio.transcription.job",
  "status": "completed",
  "model": "miyang/miyang-asr",
  "text": "Meeting transcript...",
  "duration": 93.4,
  "segments": [
    {"speaker": "0", "start": 0.0, "end": 5.2, "text": "..."}
  ],
  "usage": {
    "audio_seconds": 93.4,
    "duration_ms": 93400,
    "input_tokens": 3270,
    "output_tokens": 412
  },
  "source_file_id": "drv-..."
}

curl https://api.alice.fans/api/v1/audio/transcriptions/realtime \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Idempotency-Key: live-meeting-001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang-asr-realtime",
    "format": "pcm",
    "sample_rate": 16000,
    "source_language": "cn",
    "prompt": "这是一场米羊产品会议，参会人包括洛小山，项目名称是星潮计划。",
    "max_duration_seconds": 300,
    "output_level": 2
  }'

{
  "id": "realtime-task-id",
  "status": "ready",
  "mode": "realtime",
  "model": "miyang/miyang-asr-realtime",
  "stream_url": "wss://api.alice.fans/api/v1/audio/transcriptions/realtime/.../stream?token=...",
  "stream_token_expires_in": 600
}

// 主題變化時更新後續辨識上下文
ws.send(JSON.stringify({
  type: "context.update",
  prompt: "接下來討論星潮計劃的發布安排，負責人是洛小山。"
}));

// 收到 ContextUpdated 後繼續傳送音訊
ws.send(nextAudioChunk);

{
  "header": {"namespace": "SpeechTranscriber", "name": "SentenceEnd", "status": 20000000},
  "payload": {
    "index": 1,
    "begin_time": 0,
    "time": 1820,
    "result": "今天的会议先同步进度。",
    "words": [{"text": "今天", "startTime": 0, "endTime": 320, "punctuation": ""}]
  }
}

curl https://api.alice.fans/api/v1/audio/transcriptions \
  -H "Authorization: Bearer miyang-xxx" \
  -F "model=miyang-asr-flash" \
  -F "file=@voice-note.m4a"

{
  "text": "明天上午十点提醒我开会。",
  "model": "miyang/miyang-asr-flash",
  "usage": {"input_tokens": 125, "output_tokens": 9, "total_tokens": 134},
  "request_id": "3d7e...request"
}

curl https://api.alice.fans/api/v1/audio/speech \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang-tts-v1",
    "input": "欢迎使用米羊语音合成。",
    "voice": "longanhuan_v3.1",
    "response_format": "mp3"
  }' \
  --output speech.mp3

import WebSocket from "ws";

const ws = new WebSocket(
  "wss://api.alice.fans/api/v1/realtime?model=miyang-omni-v1-realtime",
  { headers: { Authorization: "Bearer miyang-xxx" } }
);
ws.on("open", () => {
  ws.send(JSON.stringify({
    type: "session.update",
    session: { modalities: ["text", "audio"] }
  }));
  // then send input_audio_buffer.append (Base64 PCM) and read response.audio.delta
});
ws.on("message", (data) => console.log(JSON.parse(data).type));

curl "https://api.alice.fans/api/v1/websearch/search?q=最新AI新闻" \
  -H "Authorization: Bearer miyang-xxx"

// 响应示例
{
  "code": 200,
  "message": "ok",
  "took_ms": 4200,
  "data": {
    "organic": [
      {
        "title": "AI News",
        "link": "https://example.com",
        "snippet": "Latest updates...",
        "contexts": [
          { "idx": 0, "text": "..." }
        ]
      }
    ]
  }
}

curl "https://api.alice.fans/api/v1/websearch/simple-search?q=最新AI新闻" \
  -H "Authorization: Bearer miyang-xxx"

// 响应示例
{
  "code": 200,
  "message": "ok",
  "took_ms": 950,
  "data": {
    "answerBox": {
      "title": "Latest AI news",
      "snippet": "..."
    },
    "organic": [
      {
        "title": "AI News",
        "link": "https://example.com",
        "snippet": "Latest updates..."
      }
    ]
  }
}

curl "https://api.alice.fans/api/v1/websearch/reader?url=https://go.dev" \
  -H "Authorization: Bearer miyang-xxx"

// 响应示例（content 为页面正文）
{
  "code": 200,
  "message": "ok",
  "content": "# The Go Programming Language\n\nGo is an open source programming language..."
}

curl "https://api.alice.fans/api/v1/websearch/search-news?q=OpenAI" \
  -H "Authorization: Bearer miyang-xxx"

// 响应示例
{
  "code": 200,
  "message": "ok",
  "took_ms": 4200,
  "data": {
    "organic": [
      {
        "title": "Latest OpenAI news",
        "link": "https://example.com/news",
        "snippet": "Recent product and research updates...",
        "contexts": [
          { "idx": 0, "text": "..." }
        ]
      }
    ]
  }
}

from openai import OpenAI

client = OpenAI(
    api_key="miyang-xxx",
    base_url="https://api.alice.fans/api/v1",
)

stream = client.chat.completions.create(
    model="miyang/auto",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)

for chunk in stream:
    print(chunk.choices[0].delta.content, end="")

{
  "model": "miyang/auto",
  "messages": [...],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "result",
      "schema": {
        "type": "object",
        "properties": {
          "answer": { "type": "string" }
        }
      }
    }
  }
}

{
  "usage": {
    "prompt_tokens": 1000,
    "completion_tokens": 200,
    "cache_read_input_tokens": 800,   // Anthropic
    "prompt_cache_hit_tokens": 800,    // DeepSeek
    "cached_tokens": 800               // OpenAI
  }
}

from openai import OpenAI

client = OpenAI(
    api_key="miyang-xxx",
    base_url="https://api.alice.fans/api/v1",
)

resp = client.chat.completions.create(
    model="miyang/auto",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

# 非流式
curl https://api.alice.fans/api/v1/chat/completions \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang/auto",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

# 流式
curl https://api.alice.fans/api/v1/chat/completions \
  -H "Authorization: Bearer miyang-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "miyang/auto",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'