JOWOAI
zh-cn
  • zh-cn
  • en
    JOWOAI
    zh-cn
    • zh-cn
    • en
    • JOWO AI API接入指南
    • 全局返回码说明
    • 基础
      • 获取Token
        POST
    • 字幕
      • 字幕翻译
        POST
      • 查询任务结果
        GET
      • 任务回调
        POST
    • 视频
      • 视频翻译
        POST
      • 查询任务结果
        GET
      • 任务回调
        POST

    JOWO AI API接入指南

    一、概述#

    本 API 为开发者提供了与我们系统进行交互的接口,通过 HTTP 请求来实现数据的创建、读取操作。

    二、接入准备#

    2.1 申请 API 密钥
    在开始使用 API 之前,你需要向我们的平台申请 API 密钥。申请通过后,你将获得一个唯一的 API Key 和 Secret Key,用于后续的身份验证。
    2.2 开发环境
    确保你已经安装了支持 HTTP 请求的开发工具或编程语言,例如 Python 的 requests 库、Java 的 HttpClient 等。

    三、API 基础信息#

    3.1 基本 URL
    所有的 API 请求都基于以下基本 URL:https://api.jowo.ai
    3.2 请求方法
    我们的 API 支持以下常见的 HTTP 请求方法:
    GET:用于获取资源。
    POST:用于创建新资源。
    3.3 请求头
    在每个请求中,你需要包含以下必要的请求头:
    请求头描述示例
    Content-Type请求体的格式,通常为 application/jsonapplication/json
    Authorization身份验证信息,格式为 BearerBearer token

    四、身份验证#

    我们使用 OAuth 2.0 的 Bearer Token 机制进行身份验证。在每个请求的 Authorization 请求头中,添加 Bearer 前缀和你的 Token。
    示例:Authorization: Bearer Token

    五、错误处理#

    当请求出现错误时,API 将返回相应的 HTTP 状态码和错误信息。常见的错误状态码及含义如下:
    状态码含义
    400错误的请求,通常是请求体格式不正确
    401未授权,可能是 API Key 无效或未提供
    403禁止访问,你没有权限执行该操作
    404资源未找到
    500服务器内部错误

    六、速率限制#

    为了保证服务的稳定性,我们对 API 请求设置了速率限制。目前,每个 API Key 每分钟最多可以发起 1000 次请求。当达到速率限制时,API 将返回 429 状态码。

    七、支持与反馈#

    如果你在接入过程中遇到任何问题或有任何建议,请联系我们的技术支持团队,邮箱:support@jowo.ai。
    Next
    全局返回码说明
    Built with