开发者文档

版本 2.2 · 最后更新 2026-02-24

🚀 快速入门

岐艾越斯AI中台提供四大专业智能体,所有接口通过中央网关统一代理。您只需在请求头中携带您的专属 X-API-Key 即可调用任何节点的功能。

获取您的 API Key:
  1. 注册并登录本平台(右上角“登录/注册”)
  2. 登录后点击右上角用户名进入“个人中心”
  3. 在个人中心页面查看您的 64 位 API Key,并可随时重置
第一个API调用示例(文本翻译):
curl -X POST https://ai.q-iyss.com/api/proxy/translate \
  -H "X-API-Key: 您的API密钥" \
  -H "Content-Type: application/json" \
  -d '{"text": "你好", "src_lang": "zh", "tgt_lang": "en"}'

🔐 认证与API Key

所有请求必须通过 X-API-Key 请求头传递有效的API Key。您的API Key关联您在各节点的剩余配额。

您可以在个人中心查看和重置您的API Key。重置后,旧Key将立即失效。

🌐 上海节点 · 多语言翻译

支持文本翻译,语言代码涵盖中、英、日、韩、法、德、俄、西等。

POST /api/proxy/translate

参数说明
text要翻译的文本
src_lang源语言代码,默认 auto
tgt_lang目标语言代码,默认 zh

支持语言:zh, en, ja, ko, fr, de, ru, es

curl -X POST https://ai.q-iyss.com/api/proxy/translate \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "hello world", "src_lang": "en", "tgt_lang": "zh"}'

🛳️ 海南节点 · 跨境贸易

HS编码查询: POST /api/proxy/hs 参数 hs_code

实时汇率: GET /api/proxy/currencies

合规检查: POST /api/proxy/compliance 参数 country, hs_code

🍃 广西节点 · 东盟商务

国家列表: GET /api/proxy/asean/countries

国家详情: GET /api/proxy/asean/country/

关税计算: POST /api/proxy/tariff/calculate 参数 hs_code, origin, dest

🎬 福州节点 · 影视文化

剧本生成: POST /api/proxy/script/generate 参数 genre, theme, prompt

影片搜索: GET /api/proxy/movies/search?q=关键词

杭州 · 短视频智能体

提供短视频脚本、直播话术、运营建议、系列剧本等功能,助力内容创作。

义乌 · 电商助手

商品分析、店铺管理、订单优化、竞品监控(开发中,敬请期待)。

成都 · 实体商家助手

智能点餐、外卖管理、顾客评价、菜品优化(开发中,敬请期待)。

广州 · 大宗商品贸易

大宗商品价格、仓买管理、供应链、贸易撮合(开发中,敬请期待)。

⚙️ 工作流引擎

支持将多个节点串联执行。工作流ID需在后台预定义,或通过SQL插入。

curl -X POST https://ai.q-iyss.com/api/workflow/run/1 \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"product": "笔记本电脑"}}'

💰 配额与计费

每个API调用会扣除相应节点的配额。您可在个人中心查看剩余次数。

⚠️ 错误处理

状态码说明
401缺少或无效API Key
402配额不足
404资源不存在
500内部错误