# Generate alt text

Generates concise, descriptive alt text for the provided image URL.

<Callout icon="📘" theme="info">
  ## Get Started with Image API

To use Jasper's Image endpoints, you'll need an API key. Image API access is available for customers on the Jasper Business plan with an API subscription.

**Already a Business customer?** Generate your API key in <Anchor label="Settings → API Tokens" target="_blank" href="https://app.jasper.ai/settings/dev-tools/tokens">Settings → API Tokens</Anchor>.

**New to Jasper?** [Request API access →](https://developers.jasper.ai/docs/request-image-api-access) </Callout>

<a label="LLM friendly version" href="https://developers.jasper.ai/reference/alttext.md">LLM friendly version</a>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "paths": {
    "/v1/image/alt-text": {
      "post": {
        "description": "Generates concise, descriptive alt text for the provided image URL.",
        "operationId": "altText",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImageAltTextRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The alt text was successfully generated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImageAltTextResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request. May be missing required inputs or may have badly formatted inputs or options."
          },
          "500": {
            "description": "Internal server error. Unable to remove background."
          }
        },
        "security": [
          {
            "X-API-Key": []
          },
          {
            "oauth2": [
              "user"
            ]
          }
        ],
        "summary": "Generate alt text",
        "tags": [
          "Images"
        ]
      }
    }
  },
  "info": {
    "title": "Jasper API",
    "description": "Jasper API",
    "version": "1.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.jasper.ai"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-API-Key": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Workspace authentication using API key tokens in the X-API-Key header."
      },
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://api.jasper.ai/oauth2/authorize",
            "tokenUrl": "https://api.jasper.ai/oauth2/token",
            "refreshUrl": "https://api.jasper.ai/oauth2/token",
            "scopes": {
              "user:read": "Read user information",
              "user": "Read and write user information"
            }
          }
        },
        "description": "User-level authentication using OAuth bearer tokens in the Authorization header."
      }
    },
    "schemas": {
      "ImageAltTextRequestDto": {
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "description": "The URL of the image to check.",
            "example": "https://example.com/image.png"
          }
        },
        "required": [
          "imageUrl"
        ]
      },
      "ImageAltTextResponseDto": {
        "type": "object",
        "properties": {
          "altText": {
            "type": "string",
            "description": "The alt text of the image.",
            "example": "A dog running in a field."
          }
        },
        "required": [
          "altText"
        ]
      }
    }
  },
  "x-readme": {
    "metrics-enabled": false
  }
}
```