免费模型

CokeAPI 官方福利 — 免费文本模型，走 API Key 鉴权但完全不计费。

CokeAPI 额外提供一组免费文本模型，作为平台官方福利回馈用户。这些模型同样走 OpenAI Chat Completions 协议，需要 API Key 鉴权，但完全不计费——无论调用量多少，都不会从余额扣款。

模型列表

当前可用免费模型清单以 GET /v1/models 返回为准。返回的模型 ID 已去除特殊标记，可直接使用。

当前免费模型包含（持续更新，以 API 返回为准）：

模型	来源
`deepseek-v4-flash`	DeepSeek
`mimo-v2.5`	小米
`hy3`	腾讯混元

这些模型由上游运行时动态发现，列表可能随时变化，请始终以 GET /v1/models 返回为准。

自助接入免费 API

管理员也可以通过免费 API 导入把 OpenAI 兼容的免费服务接入账号池。开启自动路由后，系统会生成形如 free/groq/llama-3.3-70b-versatile 的模型 ID。

这类模型与官方免费模型一样通过 POST /v1/chat/completions 调用；是否免费取决于后台生成路由时写入的价格配置，建议以控制台模型价格和 GET /v1/models 返回为准。

调用方式

与普通文本模型完全一致的接口 POST /v1/chat/completions，无需特殊参数。

# 可用模型: deepseek-v4-flash, mimo-v2.5, hy3
curl https://cokeapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "用一句话介绍 CokeAPI"}
    ]
  }'

from openai import OpenAI

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

# 可用模型: deepseek-v4-flash, mimo-v2.5, hy3
resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "用一句话介绍 CokeAPI"}
    ],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

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

// 可用模型: deepseek-v4-flash, mimo-v2.5, hy3
const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [
    { role: "user", content: "用一句话介绍 CokeAPI" },
  ],
});
console.log(resp.choices[0].message.content);

package main

import (
	"context"
	"fmt"
	openai "github.com/sashabaranov/go-openai"
)

func main() {
	client := openai.NewClient("sk-xxxxxxxx")
	resp, err := client.CreateChatCompletion(
		context.Background(),
		openai.ChatCompletionRequest{
			Model: "deepseek-v4-flash",
			Messages: []openai.ChatCompletionMessage{
				{Role: openai.ChatMessageRoleUser, Content: "你好"},
			},
		},
	)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(resp.Choices[0].Message.Content)
}

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.ChatCompletion;
import com.openai.models.ChatCompletionCreateParams;
import com.openai.models.ChatCompletionMessageParam;

public class Main {
    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.builder()
            .apiKey("sk-xxxxxxxx")
            .baseUrl("https://cokeapi.com/v1")
            .build();

        ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
            .addMessage(ChatCompletionMessageParam.ofUser("你好"))
            .model("deepseek-v4-flash")
            .build();

        ChatCompletion chatCompletion = client.chat().completions().create(params);
        System.out.println(chatCompletion.choices().get(0).message().content());
    }
}

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	`/v1/models` 返回的免费模型 ID
messages	array	是	—	对话历史 `[{ role, content }]`
stream	bool	否	false	true 时返回 SSE 流式响应

其余参数 (temperature / max_tokens / tools 等) 全部兼容，直接透传上游。

响应示例

{
  "id": "chatcmpl-01HX...",
  "object": "chat.completion",
  "created": 1714200000,
  "model": "deepseek-v4-flash",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hi"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 22,
    "total_tokens": 40
  }
}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant"}}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","choices":[{"delta":{"content":"Coke"}}]}

...

data: [DONE]

计费

免费模型不计费。所有请求虽然走 API Key 鉴权，但不会扣除余额，也不会计入 RPM / 日配额 / 成本窗口。

注意事项

免费模型走 CokeAPI 专用线路，响应速度可能低于付费模型。
可用性取决于上游状态，CokeAPI 会自动重试不可用的节点（最多 3 次）。
直接使用 GET /v1/models 返回的模型 ID 即可调用。