跳转到主要内容

什么是后台模式

后台模式是指在对话过程中,用户可以选择不立即等待模型的回复,而是让模型在后台处理请求,稍后再获取结果。这种模式适用于需要较长时间处理的任务,如画图、复杂推理、深度研究或多轮对话等。
典型的耗时任务模型如下:
  • o1
  • o1-pro
  • o3
  • o3-pro
  • gpt-5 复杂推理
  • gpt-5-pro
  • gpt-5-codex
  • gemini-2.5-flash 复杂推理
  • gemini-2.5-flash-image
  • gemini-2.5-pro
  • 所有模型ID中带 sonar 前缀的对话模型(需要联网搜索)
  • 所有模型ID中带 thinking 后缀的推理模型(注意不是 no-thinking),如 Claude、DeepSeek 等
  • 所有模型ID中带 search 字样的联网搜索对话模型
  • 所有模型ID中带 research 字样的深度研究推理模型
  • OpenAI 系列使用了搜索web_search)、画图image_generation)工具的对话模型
  • 所有其他内置联网搜索并开启以及使用了外部搜索工具的对话模型
  • 所有其他在对话中支持画图、语音的对话模型
当然如果你在使用其他对话模型时觉得响应较慢,也可以使用后台模式。目前仅对话完成接口非流式对话支持后台模式,画图、视频模型可以通过对应的异步模式实现后台模式。

启用后台模式对话

要使用后台模式,您需要在对话请求中设置 background 参数为 true。以下是一个示例请求:
curl --location --request POST 'https://geekai.co/api/v1/chat/completions' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gemini-2.5-pro",
    "messages": [
        {
            "role": "user",
            "content": "你好,请向一个小学生解释什么是宇称不守恒定律"
        }
    ],
    "background": true
}'
目前仅对话完成接口非流式对话支持后台模式,所以不同同时设置 streambackgroundtrue,否则会导致请求失败:
{
    "message": "only non-stream chat support background mode"
}

获取后台模式结果

一旦发起了一个后台模式的请求,将收到一个响应,其中包含一个唯一的 id 用于标识本次对话任务:
{
    "id": "4ec88c8a-9ef9-496d-bec8-711521a1c693",
    "status": "pending",
    "created": 1761375639,
    "model": "gemini-2.5-pro",
    "object": "chat.completion"
}
你可以使用这个 id 通过对话结果查询接口查询任务的状态和结果:
curl --location --request GET 'https://geekai.co/api/v1/chat/{id}' \
--header 'Authorization: Bearer $GEEKAI_API_KEY'
将上面接口路径中的 {id} 替换为你收到的任务 id 发起查询请求即可,在本例中,就是 4ec88c8a-9ef9-496d-bec8-711521a1c693。查询结果可能有以下几种状态:
  • pending:任务仍在排队中
  • running:任务正在处理中
  • succeed:任务处理成功
如果任务执行成功,则响应和非后台模式的对话完成接口响应格式相同:
{
    "id": "4ec88c8a-9ef9-496d-bec8-711521a1c693",
    "status": "succeed",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "嗨,小朋友你好!\n\n我们来玩一个“镜子世界”的游戏,你很快就能明白什么是“宇称不守恒定律”啦。\n\n### 第一步:认识我们的“镜子世界”\n\n你照过镜子吗?镜子里有一个和你长得一模一样,但是左右相反的你,对不对?\n\n*   你举起**右手**,镜子里的你举起了**左手**。\n*   你朝**东**边跑,镜子里的你朝**西**边跑。\n\n现在,我们假装有一个“镜子法则”,这个法则是说:**在我们的世界里能发生的事情,在镜子里的世界也一定能发生,而且看起来很正常。**\n\n比如:\n*   你把一个苹果扔到空中,它会掉下来。镜子里的你扔一个“镜子苹果”,它也会掉下来。这个法则没问题。\n*   你让一个陀螺顺时针转,镜子里的陀螺就会逆时针转。这也很正常,因为陀螺本来就可以逆时针转。这个法则也没问题。\n\n在很长一段时间里,所有最厉害的科学家都认为,这个“镜子法则”在宇宙的任何地方都是绝对正确的。他们给这个法则起了一个很酷的名字,叫**“宇称守恒”**。\n\n*   **“宇称”**,你就可以把它想象成“宇宙的左右对称性”。\n*   **“守恒”**,就是“保持不变”的意思。\n\n所以,“宇称守恒”就是说:**宇宙和它在镜子里的样子,遵守的是同一套规则,没有区别。**\n\n### 第二步:发现一个惊天大秘密!\n\n但是!有一天,一位非常非常聪明的女科学家,叫做**吴健雄**(你可以叫她吴奶奶),和她的同事们做了一个实验。\n\n他们观察了一些比灰尘还要小上亿万倍的“小不点”(我们叫它“粒子”)的行为。然后,他们发现了一个让所有人都惊掉下巴的秘密!\n\n他们发现,有一种小不点在“发射”更小的“小不点子弹”时,**总是喜欢朝着一个固定的方向发射**。\n\n这就好像一个神奇的陀螺:\n\n*   **在我们的世界里**,这个神奇的陀螺一边**顺时针**旋转,一边**向上**发射子弹。\n*   **在镜子世界里**,这个陀螺就应该一边**逆时针**旋转,一边**向上**发射子弹。\n\n但是吴奶奶的实验发现,这种神奇的陀螺**只会**“顺时针转+向上发射”,它**从来不会**“逆时针转+向上发射”!\n\n这一下,“镜子法则”就被打破了!因为在镜子世界里发生的事情,在我们的现实世界里根本找不到!\n\n这就说明,我们的宇宙其实有点“偏心”!在微观世界里,它并不是完全左右对称的。\n\n### 总结一下\n\n所以,**宇称不守恒定律**说的就是:\n\n**在微观小世界里,宇宙有时候会“耍赖皮”,它和它在镜子里的样子,遵守的规则不完全一样。我们的世界里发生的一些事情,在镜子世界里是永远不会发生的。**\n\n简单说,就是那个“镜子法则”(宇称守恒)被打破了,所以就叫**“宇称不守恒”**。\n\n这个发现非常了不起,因为它告诉我们,宇宙比我们想象的还要奇妙和神秘。说不定,等你长大了,也能发现宇宙的更多秘密呢!"
            },
            "finish_reason": "stop"
        }
    ],
    "model": "gemini-2.5-pro",
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 15,
        "completion_tokens": 788,
        "total_tokens": 2526,
        "completion_tokens_details": {
            "reasoning_tokens": 1723
        }
    }
}
按照非流式对话完成接口进行 JSON 反序列化即可获取响应结果。
任务结果默认会保留 7 天,7 天后任务结果将被自动删除,请及时查询和保存结果。
如果任务执行失败,则错误响应和原来非流式对话完成接口响应格式相同,你可以根据错误码和错误信息进行排查和处理。