进入后台 →
Human-in-the-loop API

看起来像 AI，
其实是你在回复。

给朋友一个标准聊天 API。他们发出请求，你在私密后台实时接收消息，决定怎么回答。自然、好玩，也完全由你掌控。

$ curl http://localhost:8787/v1/chat/completions \ -H "Authorization: Bearer hak_你的APIKey" \ -H "Content-Type: application/json" \ -d '{"messages":[{"role":"user","content":"你好"}]}'

← 我已经在等你的回答了…
① 发消息

调用 OpenAI 风格的接口，不需要特殊 SDK。

② 你来接管

后台即时出现对话，亲自写下“AI”的回答。

③ 无缝返回

回复会返回给调用方，或由对方轮询获取。

POST/v1/chat/completions

请求默认最多等待 25 秒；若你尚未回复，接口返回 202 和会话 ID，调用方可稍后轮询。

curl http://localhost:8787/v1/chat/completions \ -H "Authorization: Bearer hak_你的APIKey" \ -H "Content-Type: application/json" \ -d '{ "model": "human-behind-the-ai", "wait_seconds": 25, "messages": [{"role": "user", "content": "给我讲个冷笑话"}] }'

连续对话

第一次响应中的 conversation_id 就是会话 ID。后续调用带上它，并在 messages 里只放这一次新增的消息；后台会把所有轮次归到同一条会话。

curl http://localhost:8787/v1/chat/completions \\ -H "Authorization: Bearer hak_你的APIKey" \\ -H "Content-Type: application/json" \\ -d '{"conversation_id":"chatcmpl_上次返回的ID", "messages":[{"role":"user","content":"那再来一个"}]}'

参数

messages 必填 OpenAI 兼容消息数组，至少包含一条 user 消息。

conversation_id 可选 继续既有会话。使用时 messages 只传当前新增轮次。

wait_seconds 可选 1–55 秒，服务端等待人工答复的时间，默认 25。

model 可选 仅用于响应中回显，默认 human-behind-the-ai。