CokeAPI

5 分钟快速开始

注册、创建 API Key、替换 base_url、跑通第一条请求，最快方式接入 CokeAPI。

这页只做一件事：让你在 5 分钟内跑通第一条 CokeAPI 请求。

如果你已经用过 OpenAI SDK，除了 base_url 和 api_key，其他代码基本都不用改。

0. 开始前准备

你需要先准备 3 件事：

  1. 一个 www.cokeapi.com 账号。
  2. 一个新建好的 API Key。
  3. 一个你熟悉的调用方式：cURL、Python 或 Node.js。

接口基地址固定为 https://api.cokeapi.com/v1。后面的所有示例都基于这个地址。

1. 创建 API Key

注册并登录控制台后，进入「密钥」页：

  1. 点 「新建密钥」，给 Key 起个名字（例：my-prod-key）。
  2. 选择 scope：首次接入建议直接开 chat,image,video。
  3. 创建成功后会仅一次显示明文 sk-coke-xxxxxxxx，立刻保存到你的密钥管理工具。

关闭对话框后明文再也无法找回。如果遗失，作废旧 Key 重新创建即可。

更多鉴权细节见 鉴权。

2. 安装 SDK 或确认本地环境

pip install openai
npm install openai
# cURL 自带，无需安装

3. 先设置环境变量

建议把 API Key 放到环境变量，而不是直接写进代码。

export COKEAPI_KEY="sk-coke-xxxxxxxx"
$env:COKEAPI_KEY="sk-coke-xxxxxxxx"

4. 跑通第一条文本请求

先从文本接口开始，确认你的 Key、网络和基地址都是通的。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cokeapi.com/v1",
    api_key=os.environ["COKEAPI_KEY"],
)

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

const client = new OpenAI({
  baseURL: "https://api.cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const chat = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "用一句话介绍 CokeAPI" }],
});

console.log(chat.choices[0].message.content);
curl https://api.cokeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COKEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "用一句话介绍 CokeAPI"}]
  }'

正常情况下你会拿到一个标准 OpenAI 风格响应，其中包含：

  • choices[0].message.content：模型输出内容
  • usage：token 用量
  • id：本次请求 ID

调成功后，在控制台「消费记录」里也能看到本次扣点明细。

5. 再试一条图片请求

文本跑通后，再切换到图像接口验证你的 Key scope 和账户余额是否正常。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cokeapi.com/v1",
    api_key=os.environ["COKEAPI_KEY"],
)

img = client.images.generate(
    model="gpt-image-2",
    prompt="一只在京都樱花树下的赛博狐狸，电影质感",
    size="1024x1024",
    n=1,
)

print(img.data[0].url)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一只在京都樱花树下的赛博狐狸，电影质感",
  size: "1024x1024",
  n: 1,
});

console.log(img.data[0].url);
curl https://api.cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer $COKEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在京都樱花树下的赛博狐狸，电影质感",
    "size": "1024x1024",
    "n": 1
  }'

如果你要接视频，继续看 Grok Imagine 视频文档。

6. 首次接入最常见的 4 个问题

7. 下一步看什么

文档首页

从 quickstart、模型价格、鉴权和 SDK 示例开始，最快方式接入 CokeAPI。

鉴权

API Key 申请、使用、scope 与安全建议。

On this page

0. 开始前准备1. 创建 API Key2. 安装 SDK 或确认本地环境3. 先设置环境变量4. 跑通第一条文本请求5. 再试一条图片请求6. 首次接入最常见的 4 个问题7. 下一步看什么