跳到内容
Twexapi
简体中文
Esc
导航打开⌘J预览

向 Grok AI 发起提问

直接调用 X 内置的 Grok AI 大模型进行问答对话并获取回答。需附带 Twitter Cookie。

POST/v3/twitter/grok/ask
API 鉴权
AuthorizationBearer token · header必填
TwexAPI 平台的全局身份凭据 (Bearer Token)。所有接口调用均需在 Header 中携带:Authorization: Bearer <YOUR_TWEXAPI_KEY>。可在 TwexAPI 用户控制台获取。
请求体
必填application/json
promptstring必填
用户向大模型输入的提问或指示文本(Prompt)
conversation_idstring | any
私信会话窗口唯一标识符
展开属性
Any of:
string
string
any
any
modelstring | any
可选的大模型版本 ID(默认 grok-3-latest)。
default: "grok-3-latest"
展开属性
Any of:
string
string
any
any
cookiestring必填
用户自有授权的 Twitter 会话凭据或 auth_token(BYOC 自带 Cookie 模式)。无状态受托代理执行,凭据绝不持久化存储。详见 [鉴权与安全说明](/zh/authentication#写操作鉴权与-byoc自带授权-cookie--token) 与 [获取 Cookie 指南](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie)。
proxystring | any
可选配置的 HTTP 代理地址,格式示例:http://username:password@ip:port
展开属性
Any of:
string
string
any
any
响应结果
200Grok AI 生成的最终回复内容。
codeinteger必填
HTTP 响应状态码(200 表示成功)
msgstring必填
响应提示信息(例如 'success')
dataGrokAskResult | any
接口返回的核心业务数据载荷
展开属性
Any of:
GrokAskResult
conversation_idstring必填
私信会话窗口唯一标识符
user_chat_item_idstring | any
用户发起提问的消息项 ID
展开属性
Any of:
string
string
any
any
agent_chat_item_idstring | any
智能体对话条目 ID
展开属性
Any of:
string
string
any
any
messagestring必填
Grok AI 生成的最终回答内容
reasoningstring | any
大模型在输出前生成的深度推理/思考过程文本(Reasoning Trace)
展开属性
Any of:
string
string
any
any
soft_stopboolean | any
大模型输出是否因为达到设定的软停止条件而截断
展开属性
Any of:
boolean
boolean
any
any
follow_up_suggestionsGrokFollowUpSuggestion[]
后续追问引导建议列表
展开属性
Array of GrokFollowUpSuggestion
labelstring必填
后续追问建议的标题文本
propertiesobject | any
后续建议参数对象
展开属性
Any of:
object
object
any
any
tools_overridesobject | any
工具调用覆写配置
展开属性
Any of:
object
object
any
any
any
any
422请求参数校验错误
detailValidationError[]
展开属性
Array of ValidationError
locstring | integer[]必填
展开属性
Array of string | integer
Any of:
string
string
integer
integer
msgstring必填
响应提示信息(例如 'success')
typestring必填
inputany
ctxobject
交互式测试POST
交互式测试 / Try APIPOST
Live Console
🌐目标服务器:https://api.twexapi.io
● 生产环境就绪
✍️
写入接口凭证指引(TwexAPI 密钥 + 目标推特 Cookie)

1. TwexAPI 平台密钥 (Bearer Token):在下方「API 鉴权」中填入,用于 TwexAPI 计费与接口调用鉴权。

2. 推特账号 Cookie:本接口为代发/点赞/关注等写操作,需在下方请求体 (Request Body)cookie 字段中填入目标 Twitter 账号的 Cookie 凭据(如 auth_token=...; ct0=...)。

🔑API 鉴权
📝请求体application/json
📡
暂无响应数据

请在「请求配置」中确认参数后,点击底部的「发送请求」按钮。

请求示例
curl -X POST "https://api.twexapi.io/v3/twitter/grok/ask" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Say hi in one sentence.",
  "conversation_id": "2076320454898278729",
  "model": "grok-3-latest",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
}'
响应示例
{
  "code": 200,
  "msg": "success",
  "data": {
    "conversation_id": "2076320454898278729",
    "user_chat_item_id": "string",
    "agent_chat_item_id": "string",
    "message": "Hi there!",
    "reasoning": "Thinking about your request",
    "soft_stop": true,
    "follow_up_suggestions": [
      {
        "label": "Learn about conversational AI",
        "properties": {},
        "tools_overrides": {}
      }
    ]
  }
}