CokeAPI
SDK 与集成

Python SDK

用 OpenAI Python SDK 接入 CokeAPI,所有 chat / images / video 接口零改动。

CokeAPI 与 OpenAI 协议完全兼容,直接用 OpenAI 官方 Python SDK 即可,不需要单独的 SDK。

安装

pip install openai
# 推荐 1.50+ 版本

基础用法

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

# 文本
resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "用一句话介绍 CokeAPI"}],
)
print(resp.choices[0].message.content)

流式

stream = client.chat.completions.create(
    model="grok-4.20-fast",
    messages=[{"role": "user", "content": "讲个三句的笑话"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

异步 / 并发

import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

async def main():
    tasks = [
        client.chat.completions.create(
            model="gpt-4o-mini",
            messages=[{"role": "user", "content": q}],
        )
        for q in ["你好", "再见", "晚安"]
    ]
    results = await asyncio.gather(*tasks)
    for r in results:
        print(r.choices[0].message.content)

asyncio.run(main())

错误处理

from openai import OpenAI, RateLimitError, APIStatusError

try:
    client.chat.completions.create(...)
except RateLimitError as e:
    # 429,看 Retry-After 头退避
    print("被限流,等待重试")
except APIStatusError as e:
    # 其他 4xx / 5xx
    print(f"业务错误: code={e.body.get('error', {}).get('code')}, "
          f"trace_id={e.body.get('error', {}).get('trace_id')}")

本页目录

安装基础用法流式异步 / 并发错误处理