EMOXIA AI API 接入与模型调用手册

export EMOXIA_BASE_URL='https://emoxia.meta-api.vip/v1'
read -r -s -p 'EMOXIA API Key: ' EMOXIA_API_KEY
printf '\n'
export EMOXIA_API_KEY

curl --fail-with-body -sS --max-time 30 \
  "$EMOXIA_BASE_URL/models" \
  -H "Authorization: Bearer $EMOXIA_API_KEY"

curl --fail-with-body -N --max-time 180 \
  "$EMOXIA_BASE_URL/responses" \
  -H "Authorization: Bearer $EMOXIA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "gpt-6-astra",
    "input": "请用一句话介绍你能提供的帮助。",
    "max_output_tokens": 1024,
    "stream": true
  }'

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"你好"}

event: response.completed
data: {"type":"response.completed","response":{...}}

curl --fail-with-body -N --max-time 180 \
  "$EMOXIA_BASE_URL/messages" \
  -H "Authorization: Bearer $EMOXIA_API_KEY" \
  -H "x-api-key: $EMOXIA_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "claude-opus-4-8",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "请用一句话介绍你能提供的帮助。"}
    ],
    "stream": true
  }'

curl --fail-with-body -N --max-time 180 \
  "$EMOXIA_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $EMOXIA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "请用一句话介绍你能提供的帮助。"}
    ],
    "max_tokens": 1024,
    "stream": true
  }'

python -m pip install requests

import json
import os
import requests

BASE = "https://emoxia.meta-api.vip/v1"
KEY = os.environ["EMOXIA_API_KEY"]
PROTOCOL = "responses"
MODEL = "gpt-6-astra"
# 其他组合：messages / claude-opus-4-8
# 其他组合：chat / deepseek-v4-flash
PROMPT = "请用一句话介绍你能提供的帮助。"


def sse_frames(response):
    event, lines = "", []
    for line in response.iter_lines(decode_unicode=True):
        if line == "":
            if lines:
                yield event, "\n".join(lines)
            event, lines = "", []
        elif line.startswith("event:"):
            event = line[6:].lstrip(" ")
        elif line.startswith("data:"):
            lines.append(line[5:].lstrip(" "))
        # 注释心跳以及其他 SSE 字段不当成正文。
    if lines:
        yield event, "\n".join(lines)


headers = {
    "Authorization": "Bearer " + KEY,
    "Content-Type": "application/json",
    "Accept": "text/event-stream",
}
if PROTOCOL == "responses":
    path = "/responses"
    body = dict(model=MODEL, input=PROMPT,
                max_output_tokens=1024, stream=True)
elif PROTOCOL == "messages":
    path = "/messages"
    headers.update({"x-api-key": KEY,
                    "anthropic-version": "2023-06-01"})
    body = dict(model=MODEL, max_tokens=256, stream=True,
                messages=[dict(role="user", content=PROMPT)])
elif PROTOCOL == "chat":
    path = "/chat/completions"
    body = dict(model=MODEL, max_tokens=1024, stream=True,
                messages=[dict(role="user", content=PROMPT)])
else:
    raise ValueError("PROTOCOL 必须是 responses、messages 或 chat")

completed, text_seen = False, False
with requests.post(BASE + path, headers=headers, json=body,
                   stream=True, timeout=(10, 180)) as response:
    response.raise_for_status()
    content_type = response.headers.get("Content-Type", "")
    if "text/event-stream" not in content_type.lower():
        raise RuntimeError("预期 SSE，实际收到 " + content_type)
    response.encoding = "utf-8"
    for event, data in sse_frames(response):
        if data == "[DONE]":
            if PROTOCOL != "chat":
                raise RuntimeError("收到与所选协议不匹配的结束标志")
            completed = True
            break
        obj = json.loads(data)
        kind = obj.get("type") or event
        if obj.get("error") or kind in {
            "error", "response.failed", "response.incomplete"
        }:
            raise RuntimeError("流式响应失败或未完成：" + str(kind))
        terminal = {
            "responses": "response.completed",
            "messages": "message_stop",
        }.get(PROTOCOL)
        if terminal and kind == terminal:
            completed = True
            break
        delta = ""
        if kind == "response.output_text.delta":
            delta = obj.get("delta", "")
        elif kind == "content_block_delta":
            block = obj.get("delta", {})
            if block.get("type") == "text_delta":
                delta = block.get("text", "")
        elif PROTOCOL == "chat":
            for choice in obj.get("choices", []):
                value = choice.get("delta", {}).get("content")
                if isinstance(value, str):
                    delta += value
        if isinstance(delta, str) and delta:
            text_seen = True
            print(delta, end="", flush=True)
if not completed:
    raise RuntimeError("流已关闭，但未收到协议完成标志")
if not text_seen:
    raise RuntimeError("流已结束，但该文本测试没有收到正文")
print()

curl --fail-with-body -sS --max-time 360 \
  "$EMOXIA_BASE_URL/images/generations" \
  -H "Authorization: Bearer $EMOXIA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A blue circle on a plain white background.",
    "n": 1,
    "size": "1024x1024"
  }'

python -m pip install requests pillow

import base64
import io
import os
import uuid
from pathlib import Path
import requests
from PIL import Image

url = "https://emoxia.meta-api.vip/v1/images/generations"
headers = {"Authorization": "Bearer " +
           os.environ["EMOXIA_API_KEY"]}
body = {
    "model": "gpt-image-2.5-flare",
    "prompt": "A blue circle on a plain white background.",
    "n": 1,
    "size": "1024x1024",
}
response = requests.post(url, headers=headers, json=body,
                         timeout=(10, 360))
response.raise_for_status()
result = response.json()
if result.get("error"):
    raise RuntimeError("图像接口返回错误")
items = result.get("data", [])
if not items or not items[0].get("b64_json"):
    raise RuntimeError("未收到本示例要求的 b64_json 图片数据")
raw = base64.b64decode(items[0]["b64_json"], validate=True)
with Image.open(io.BytesIO(raw)) as picture:
    picture.load()
    output = Path("emoxia-" + uuid.uuid4().hex[:12] + ".png")
    picture.save(output, format="PNG")
    print("已保存", output, "尺寸", picture.size)

import os
import secrets
from pathlib import Path
import requests

url = "https://emoxia.meta-api.vip/v1/audio/speech"
request_id = secrets.token_hex(32)
headers = {
    "Authorization": "Bearer " + os.environ["EMOXIA_API_KEY"],
    "Content-Type": "application/json",
    "Idempotency-Key": request_id,
}
body = {
    "model": "tts-1",
    "input": "欢迎使用 EMOXIA。",
    "voice": "emo-xiaoning",
    "response_format": "mp3",
    "metadata": {"emoxia_request_id": request_id},
}
response = requests.post(url, headers=headers, json=body,
                         timeout=(10, 180))
response.raise_for_status()
content_type = response.headers.get("Content-Type", "").lower()
mime = content_type.split(";", 1)[0].strip()
if mime not in {"audio/mpeg", "audio/mp3"} or not response.content:
    raise RuntimeError("预期非空 MP3 音频，实际响应不符合要求")
output = Path("emoxia-" + request_id[:12] + ".mp3")
output.write_bytes(response.content)
print("已保存", output)

$secret = Read-Host 'EMOXIA API Key' -AsSecureString
$credential = New-Object System.Net.NetworkCredential('', $secret)
$env:EMOXIA_API_KEY = $credential.Password
$credential = $null
$secret = $null
$env:EMOXIA_BASE_URL = 'https://emoxia.meta-api.vip/v1'

curl.exe --fail-with-body -sS --max-time 30 `
  "$env:EMOXIA_BASE_URL/models" `
  -H "Authorization: Bearer $env:EMOXIA_API_KEY"
if ($LASTEXITCODE -ne 0) { throw '模型列表请求失败' }

$body = @'
{
  "model": "gpt-6-astra",
  "input": "请回复一句中文问候。",
  "max_output_tokens": 1024,
  "stream": true
}
'@
$filename = 'emoxia-' + [guid]::NewGuid().ToString('N') + '.json'
$jsonFile = Join-Path $env:TEMP $filename
$utf8 = New-Object System.Text.UTF8Encoding($false)
[System.IO.File]::WriteAllText($jsonFile, $body, $utf8)
try {
  curl.exe --fail-with-body -N --max-time 180 `
    "$env:EMOXIA_BASE_URL/responses" `
    -H "Authorization: Bearer $env:EMOXIA_API_KEY" `
    -H 'Content-Type: application/json' `
    --data-binary "@$jsonFile"
  if ($LASTEXITCODE -ne 0) { throw '请求失败或达到 curl 时限' }
} finally {
  Remove-Item -LiteralPath $jsonFile -ErrorAction SilentlyContinue
}

Remove-Item Env:EMOXIA_API_KEY -ErrorAction SilentlyContinue

发生时间及所在时区：
客户端或程序名称与版本：
分组 VIP 或 GGVIP：
精确模型 ID：
请求路径：
是否流式：
HTTP 状态码：
完整错误文字或脱敏截图：
请求 ID：
是否收到正文及最后一个事件名：
首正文等待时间与总耗时：
单并发最小请求是否也能复现：
是否自动重试以及重试次数：