Commerce AI（预览 · Invite Only）

预览 · Invite Only。 这是能力预告与技术评估页面。未获得 HIOBuy 书面邀请，请勿在生产环境直接调用。

商业价格未发布。 当前出现的 credits 仅用于受邀评估阶段的技术计量，不代表套餐、报价或未来商业收费承诺。

建议入口： 查看预览说明或 联系 HIOBuy 申请受邀评估。

覆盖能力

能力API典型用途
标题、SKU、属性与描述翻译POST /v1/ai/text/translate保持商品文案与店铺语言一致
商品本地化POST /v1/ai/product/localize / POST /v1/ai/product/localize/jobs为目标市场生成可上架的标题、卖点、属性与副本
图片文字翻译POST /v1/ai/image/jobs（replace_chinese_text）保留商品图版式的前提下翻译图中文字
去除中文文字/标签/促销牛皮癣POST /v1/ai/image/jobs（remove_chinese_text）清理混杂噪音，提升图片可发布性
商品白底图POST /v1/ai/image/jobs（white_background）标准化白底图
智能高清POST /v1/ai/image/jobs（enhance / upscale）改善低清图质量与缩放效果
图片分析POST /v1/ai/image/analyze上线前检查清晰度、文字、标签、拼图风险
定价建议POST /v1/ai/pricing/suggest结合汇率与倍率生成建议售价

接入与环境约束

  1. 本能力不对外自助开通，需 HIOBuy 书面邀测或合作审批。
  2. 未获邀测权限时，不得用于生产调用。
  3. X-Shop-Domain 用作稳定工作区标识，重复请求请复用稳定值。
  4. 所有计费或异步操作建议带 X-Idempotency-Key。
  5. 图片任务为异步，需通过 Job 接口轮询。

请求头与基址

Authorization: Bearer hio_live_xxx
X-Shop-Domain: demo-store.myshopify.com
X-Idempotency-Key: demo-store.myshopify.com:commerce-ai:request-001
Content-Type: application/json

路由清单

Commerce AI 主能力（OpenAPI 标签）

MethodPathAuth
POST/v1/ai/text/translateAPI Key + headers
POST/v1/ai/product/localizeAPI Key + headers
POST/v1/ai/product/localize/jobsAPI Key + headers
POST/v1/ai/image/analyzeAPI Key + headers
POST/v1/ai/image/jobsAPI Key + headers
GET/v1/ai/jobs/:job_idAPI Key
GET/v1/ai/assets/:job_id.webpPublic
POST/v1/ai/pricing/suggestAPI Key + headers

AI Credits 计量（OpenAPI 标签）

MethodPathAuth
GET/v1/ai/creditsAPI Key
POST/v1/ai/credits/estimateAPI Key + headers
GET/v1/ai/credits/transactionsAPI Key + headers
GET/v1/ai/credits/pricingAPI Key

POST /v1/ai/text/translate

适用于商品标题、SKU、属性、描述翻译。

{
  "texts": [
    "夏季纯棉短袖T恤",
    "白色",
    "加大码"
  ],
  "source_language": "zh",
  "target_language": "en",
  "format_type": "text",
  "scene": "e-commerce-title"
}

scene 常用值：e-commerce-title、e-commerce-description、e-commerce-cpv、e-commerce-chat。

POST /v1/ai/product/localize

商品详情级本地化（同步）：

{
  "source": "1688",
  "source_url": "https://detail.1688.com/offer/example.html",
  "origin_language": "zh-CN",
  "language": "en",
  "target_market": "US",
  "shop_currency": "USD",
  "product": {
    "title": "厂家直销 桌面收纳盒",
    "description": "适用于办公桌、化妆台、厨房台面。",
    "attributes": [
      {
        "name": "材质",
        "value": "塑料"
      },
      {
        "name": "颜色",
        "value": "白色 / 绿色"
      }
    ]
  },
  "preferences": {
    "tone": "professional",
    "avoid_claims": true,
    "title_max_length": 80,
    "seo_title_max_length": 70,
    "seo_description_max_length": 160
  }
}

POST /v1/ai/product/localize/jobs

异步版本，返回 Job 后通过 GET /v1/ai/jobs/{job_id} 轮询。

状态流程：queued → running → completed / failed。

POST /v1/ai/image/jobs

支持 type：

  • replace_chinese_text
  • remove_chinese_text
  • white_background
  • replace_background
  • enhance
  • upscale
  • lifestyle_generation
{
  "type": "remove_chinese_text",
  "image_url": "https://cdn.example.com/original-product.jpg"
}

replace_chinese_text 需补充 target_language。

POST /v1/ai/image/analyze

{
  "shop": "demo-store.myshopify.com",
  "target_market": "US",
  "images": [
    {
      "url": "https://cdn.example.com/original-product.jpg",
      "role": "cover"
    }
  ]
}

返回值会标记 contains_chinese_text、has_watermark、quality_score、shopify_readiness、recommended_actions。

POST /v1/ai/pricing/suggest

{
  "shop": "demo-store.myshopify.com",
  "origin_amount": 38.5,
  "origin_currency": "CNY",
  "shop_currency": "USD",
  "exchange_rate": 0.14,
  "multiplier": 2.8,
  "rounding": "x.99"
}

Credits 说明

  • credits 为预览期技术计量单位，仅用于受邀测试与评估。
  • 数值、配额与换算规则可调整，且不代表正式商业价格。
  • 生产阶段的正式商业条款以 HIOBuy 书面邀测协议为准。

Commerce AI 预览访问

请按以下顺序进行受邀评估：

  1. 阅读并确认场景能力覆盖。
  2. 与 HIOBuy 对齐目标市场、图像体量和日/周请求规模。
  3. 通过邮件提交评估申请。
  4. 获取书面邀请后再开启生产接入。

联系申请：support@hiobuy.com

OpenAPI 规范请见：https://api.hiobuy.com/openapi.json 

获取支持

需要集成帮助？请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复

发送邮件