Name: Image Translator – Localize Visuals | Free · $5/mo | API.market
Brand: astrosoft
SKU: api-astrosoft-translate-image
Availability: InStock
Author: API Market

cin ceoi

# 🖼️→🖼️ Image Translation API Documentation

## Overview

The Image Translation API leverages advanced AI to translate text present within images into a language of your choice. This service allows you to localize visuals without altering the original design, making it ideal for applications requiring multilingual support, content localization, and accessibility improvements. The API analyzes the image, detects text elements, translates them, and seamlessly integrates the translated text back into the original image.

## Features

*   **Accurate Text Detection:**  Detects text within images with high precision, even in complex layouts and fonts.
*   **High-Quality Translation:** Employs state-of-the-art machine translation models to ensure accurate and natural-sounding translations.
*   **Seamless Integration:** Replaces original text with translated text while preserving the visual integrity of the image.
*   **Multiple Language Support:** Supports translation to a wide range of languages.
*   **Easy-to-Use API:**  Provides a simple and intuitive API for developers to integrate image translation into their applications.

## Use Cases

*   **E-commerce Localization:**  Translate product images and marketing materials for international markets to reach a wider customer base.
*   **Social Media Content Translation:** Automatically translate text in images posted on social media platforms to improve user engagement and accessibility.
*   **Educational Material Adaptation:** Localize educational diagrams, infographics, and visual aids for multilingual classrooms.
*   **Global Advertising Campaigns:** Adapt ad creatives to different languages and regions without redesigning the entire campaign.
*   **Tourism and Travel Apps:** Translate signage and informational displays in images for tourists visiting foreign countries.

## Visual Examples

Here's an example of an image before and after translation using the API.

| Input Image                                                                                                  | Output Image (Translated to English)                                                                          |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| ![Original image with text](https://apimarket-file.s3.us-east-1.amazonaws.com/samples/sample_text_image.png) | ![Translated image with text](https://apimarket-file.s3.us-east-1.amazonaws.com/samples/image_translated.png) |

## Pricing

*   1 API unit equals 1 image processed.
*   Different pricing tiers are available based on usage volume. Contact API.market for more information.

## API Documentation

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/magicapi/translate-image`

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Synchronous Processing

**IMPORTANT**: This API uses synchronous processing. The translated image URL is returned directly in the response. No polling is required.

### Endpoints

#### 1. Translate Image

**POST /translate_image**

Translates text in an image to a specified language.

**Request Body:**

```json
{
  "image_url": "https://apimarket-file.s3.us-east-1.amazonaws.com/samples/sample_text_image.png",
  "language": "English"
}
```

**Request Parameters:**

*   `image_url` (string, required): URL of the image containing text to translate. The image must be publicly accessible.
*   `language` (string, optional): Target language for translation. Defaults to `"English"`. Example: `"Chinese"`, `"Japanese"`, `"French"`.

**Response (200 OK):**

```json
{
  "status": "success",
  "output": [
    "https://apimarket-file.s3.us-east-1.amazonaws.com/generates/image_translated.png"
  ]
}
```

**Response Parameters:**

*   `status` (string): Indicates the status of the translation process (`"success"`).
*   `output` (array): An array containing the URL of the translated image.

**Curl Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/translate-image/translate_image" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
           "image_url": "https://apimarket-file.s3.us-east-1.amazonaws.com/samples/sample_text_image.png",
           "language": "English"
         }'
```

**Error Responses:**

*   **400 Bad Request:**  `image_url` is missing.
    ```json
    {
      "status": "error",
      "message": "image_url is required"
    }
    ```
*   **500 Internal Server Error:** An error occurred during the translation process.
    ```json
    {
      "status": "error",
      "message": "Error: <error details>"
    }
    ```

#### 2. Upload Image

**POST /upload**

Uploads one or more images. This endpoint is useful if you don't have a publicly accessible URL for your image.

**Request Body (multipart/form-data):**

Use `multipart/form-data` to upload the image file.

```
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="image.jpg"
Content-Type: image/jpeg

(binary image data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--
```

**Request Parameters:**

*   `file` (binary, required): Image file to upload.

**Response (200 OK):**

```json
{
  "status": "success",
  "files": [
    {
      "filename": "uploaded_image.jpg",
      "url": "https://apimarket-file.s3.us-east-1.amazonaws.com/uploads/uploaded_image.jpg"
    }
  ]
}
```

**Response Parameters:**

*   `status` (string): Indicates the status of the upload process (`"success"`).
*   `files` (array): An array of objects, each containing information about an uploaded file.
    *   `filename` (string): The name of the uploaded file.
    *   `url` (string): The URL of the uploaded file.

**Curl Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/translate-image/upload" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -F "file=@/path/to/your/image.jpg"
```

**Error Responses:**

*   **400 Bad Request:** Invalid file format or no multipart data provided.
*   **500 Internal Server Error:**  An error occurred during the upload process.

## Status Codes

*   **200 OK:** Request successful. The image was successfully translated (or uploaded).
*   **400 Bad Request:** Invalid input parameters or malformed request. For example, missing the `image_url` parameter in the translate image request or uploading a file with an unsupported format.
*   **401 Unauthorized:** Missing or invalid API key in the `x-api-market-key` header.
*   **500 Internal Server Error:** An unexpected error occurred on the API server. Try again later. If the problem persists, contact API.market support.

## Rate Limits

Contact API.market for information on current rate limits and available plans.

## Implementation Guide

### Example Code

Here are code samples in JavaScript and Python demonstrating how to use the Image Translation API.

```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/translate-image";

async function translateImage(imageUrl, language) {
  const response = await fetch(`${baseUrl}/translate_image`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-market-key": apiKey
    },
    body: JSON.stringify({ image_url: imageUrl, language: language })
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status} ${response.statusText}`);
  }

  const data = await response.json();
  return data.output[0];
}

// Example Usage
async function main() {
  try {
    const imageUrl = "https://apimarket-file.s3.us-east-1.amazonaws.com/samples/sample_text_image.png";
    const translatedImageUrl = await translateImage(imageUrl, "English");
    console.log("Translated Image URL:", translatedImageUrl);
  } catch (error) {
    console.error("Failed to translate image:", error);
  }
}

main();
```

```python
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/translate-image"

def translate_image(image_url, language="English"):
    headers = {
        "Content-Type": "application/json",
        "x-api-market-key": API_KEY
    }
    payload = {
        "image_url": image_url,
        "language": language
    }
    response = requests.post(f"{BASE_URL}/translate_image", headers=headers, json=payload)

    if response.status_code == 200:
        return response.json()["output"][0]
    else:
        raise Exception(f"API error: {response.status_code} - {response.text}")

# Example Usage
if __name__ == "__main__":
    image_url = "https://apimarket-file.s3.us-east-1.amazonaws.com/samples/sample_text_image.png"

    try:
        translated_image_url = translate_image(image_url, "English")
        print(f"Translated Image URL: {translated_image_url}")
    except Exception as e:
        print(f"Error: {e}")
```

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/translate-image/translate_image" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
           "image_url": "https://apimarket-file.s3.us-east-1.amazonaws.com/samples/sample_text_image.png",
           "language": "English"
         }'

# Response:
# {"status": "success", "output": ["https://apimarket-file.s3.us-east-1.amazonaws.com/generates/image_translated.png"]}
```

### Performance Optimization

*   **Optimize Image Size:** Reduce the size of the input images to minimize processing time. Smaller images translate faster.
*   **Cache Translated Images:** Cache the translated images to avoid re-translating the same images multiple times.
*   **Monitor API Usage:** Regularly monitor your API usage to identify potential bottlenecks and optimize your implementation.

## FAQ

**Q: What image formats are supported?**

A: The API supports common image formats such as JPEG, PNG, and WebP.

**Q: What languages are supported for translation?**

A: The API supports a wide range of languages. You can specify any language name (e.g., "Chinese", "Japanese", "French", "Spanish") as the `language` parameter. If the provided language name is not recognized, the API will default to translating to English.

**Q: How long does it take to translate an image?**

A: The translation time depends on the size and complexity of the image. Typically it takes a few seconds to under a minute.

**Q: How can I improve the accuracy of the translation?**

A: Ensure that the input image has clear and legible text. The quality of the image affects the accuracy of the text detection and translation.

**Q: What if my image has no text?**

A: The API will return the image as-is or with minimal changes if no translatable text is detected.




Translate in-image text to any language instantly. Preserves original design. Free 5 calls/mo, paid plans from $5/mo. Start free on API.market.

Image Translator – Localize Visuals | Free · $5/mo | API.market

Free

AstroSoft

Basic

Translate text in images to any language using AI. Simply provide an image URL and target language — get back a translated image with all visuals preserved.