JOWOAI
en
  • zh-cn
  • en
    JOWOAI
    en
    • zh-cn
    • en
    • JOWO AI API Integration Guide
    • Global ErrorCode Description
    • Basic
      • Get Token
        POST
    • Subtitle
      • Subtitle Translation
        POST
      • Query Task Result
        GET
    • Video
      • Video Translation
        POST
      • Query Task Result
        GET

    JOWO AI API Integration Guide

    1. Overview#

    This API provides developers with an interface to interact with our system, enabling data creation and retrieval through HTTP requests.

    2. Getting Started#

    2.1 Apply for an API Key
    Before using the API, you need to apply for an API key from our platform. Once approved, you will receive a unique API Key and Secret Key, which are required for authentication.
    2.2 Development Environment
    Ensure that you have installed development tools or programming languages that support HTTP requests, such as Python’s requests library, Java’s HttpClient, etc.

    3. API Basics#

    3.1 Base URL
    All API requests are based on the following base URL: https://api.jowo.ai
    3.2 HTTP Methods
    Our API supports the following common HTTP methods:
    GET: Used to retrieve resources.
    POST: Used to create new resources.
    3.3 Request Headers
    Each request must include the following required headers:
    HeaderDescriptionExample
    Content-TypeFormat of the request body, typically application/jsonapplication/json
    AuthorizationAuthentication information, in the format of BearerBearer token

    4. Authentication#

    We use the OAuth 2.0 Bearer Token mechanism for authentication. Add the Bearer prefix followed by your token in the Authorization header of each request.
    Example: Authorization: Bearer Token

    5. Error Handling#

    When a request fails, the API will return the corresponding HTTP status code along with an error message. Common error codes and their meanings are as follows:
    Status CodeMeaning
    400Bad request, usually due to malformed request body
    401Unauthorized, possibly due to an invalid or missing API Key
    403Forbidden, you do not have permission to perform this action
    404Resource not found
    500Internal server error

    6. Rate Limiting#

    To ensure service stability, we impose rate limits on API requests. Currently, each API Key can make up to 1000 requests per minute. When the rate limit is reached, the API will return a 429 status code.

    7. Support and Feedback#

    If you encounter any issues or have suggestions during the integration process, please contact our technical support team at: support@jowo.ai.
    Next
    Global ErrorCode Description
    Built with