高阶教程：火龙果写作API接入高效开发流程-人工智能-PHP中文网

要将火龙果写作嵌入开发工作流，需通过api调用：先在企业版后台开通权限并获取appid/appsecret，再请求access token；接着调用/v1/check接口校对文本，按mode指定语法或风格检查，解析error_list提取错误位置与建议。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

高阶教程：火龙果写作api接入高效开发流程

要让火龙果写作的文本校对、风格优化能力嵌入你现有的开发工作流，比如CI/CD自动检查PR提交的文案、或集成进内部CMS后台实时提示语病，必须绕过网页端手动操作，直接调用其开放API完成结构化交互。

确认API接入权限与密钥

登录火龙果写作企业版后台，在【开发者中心】→【API管理】中创建新应用，获取 【AppID 和 AppSecret】。免费试用账号默认不开放API调用权限，需联系商务开通企业授权后才显示“创建应用”按钮。

复制生成的 AppID 和 AppSecret，本地保存为环境变量：APP_ID=xxx、APP_SECRET=yyy。切勿硬编码在源码里，否则Git泄露将导致账号被恶意调用。

获取访问令牌（Access Token）

火龙果API所有接口均需携带有效 Access Token，有效期2小时，需每次调用前刷新。

向 https://api.huolongguo.com/oauth2/token 发起 POST 请求，Body 为 x-www-form-urlencoded 格式：

grant_type=client_credentials&client_id={你的AppID}&client_secret={你的AppSecret}

响应成功后提取 JSON 中的 access_token 字段值，后续所有请求的 Authorization Header 必须设为：Bearer {access_token}。

提交文本进行语法纠错

方法一：基础校对（同步返回）

php获得文件的mime type类

下载

向 https://api.huolongguo.com/v1/check 发起 POST 请求，Header 加入 Authorization，Body 为 JSON：

{"text": "今天天气很好，我们一起去公园玩。", "mode": "grammar"}

mode 可选 grammar（语法）、style（风格）、all（全量），选错 mode 会导致返回字段缺失关键信息，比如 mode=grammar 时不会返回“口语化建议”字段。

方法二：长文本分块异步处理

单次请求 text 字段最大支持 5000 字符；超长内容需按句号、问号、感叹号或换行符切分为段落，每段独立调用 /v1/check → 汇总各段 result → 合并 error_list 并去重定位偏移量。注意：原始文本若含 HTML 标签，需先 strip 或转义，否则解析会失败。

解析并提取纠错结果

第一步：检查 response.status_code 是否为 200，非200一律视为认证失败或限流，立即暂停重试并记录 error_msg。

第二步：读取 response.json()，确认 data.result 字段存在且不为空。空 result 表示该文本无问题，但不代表 API 调用成功——需同时核验 data.code === 0。

第三步：遍历 data.result.error_list 数组，每个 error 对象含 type（如“主谓不一致”）、pos_start（字符起始位置）、pos_end（字符结束位置）、suggestion（修正建议）。注意：pos_start 和 pos_end 是基于原始 text 的 UTF-8 字符索引，不是字节数，Python 中直接用 text[pos_start:pos_end] 即可定位错误片段。