API Documentation — FlowerWolf

Base URL： https://flowerwolf.net/v1

Auth Method：Header Authorization: Bearer <YOUR_TOKEN>，Get your token from the user dashboard。

GET /v1/models

List all currently available models. No authentication required.

Param	In	Type	Description
此端点不需要任何Param

Request Example

curl https://flowerwolf.net/v1/models

Response Example

{
  "models": [
    {"name": "gpt-4o", "upstream_model": "gpt-4o"},
    {"name": "claude-3-5-sonnet-20240620", "upstream_model": "claude-3-5-sonnet-20240620"},
    {"name": "gemini-1.5-pro", "upstream_model": "gemini-1.5-pro"},
    {"name": "deepseek-chat", "upstream_model": "deepseek-chat"},
    {"name": "qwen-turbo", "upstream_model": "qwen-turbo"}
  ]
}

POST /v1/chat/completions

OpenAI Compatible的 Chat Completions 接口。支持所有主流模型，按实际使用量从账户余额扣费。

Param	In	Type	Required	Description
model	body	string	是	Model name，如 `gpt-4o`、`claude-3-5-sonnet-20240620`
messages	body	array	是	Message array, same format as OpenAI
max_tokens	body	int	否	Max output tokens（部分模型Required）
temperature	body	float	否	Sampling temperature, between 0–2
stream	body	bool	否	Enable streaming (SSE)

Request Example

curl https://flowerwolf.net/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "max_tokens": 256
  }'

Response Example

{
  "id": "chatcmpl-xxx",
  "model": "gpt-4o",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    },
    "finish_reason": "stop",
    "index": 0
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 18,
    "total_tokens": 28
  }
}

💡 SDK Example (Python):

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_TOKEN",
    base_url="https://flowerwolf.net/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

Error Codes

状态码	Description
`200`	请求成功
`400`	Bad request，如模型不存在或未启用
`401`	Unauthorized — invalid or missing token
`402`	Insufficient balance
`429`	Rate limit exceeded
`502`	Upstream provider error

Reference Pricing (per million tokens)

模型	供应商	输入价格	输出价格
GPT-4o	OpenAI	$5.00	$15.00
Claude 3.5 Sonnet	Anthropic	$3.00	$15.00
Gemini 1.5 Pro	Google	$3.50	$10.50
DeepSeek Chat	DeepSeek	$0.14	$0.28
Qwen Turbo	Alibaba	$0.50	$2.00
Llama 3.1 70B	Meta	$0.99	$2.49

💡 Prices shown are for reference only. Bulk pricing available. Contact Sales →