img-alt-api

October 10, 2025 ยท View on GitHub

Simple API endpoint for image alt description generation, powered by OpenAI Vision.

This is inspired by Ice Cubes. It's really cool.

Development

Requires Deno.

Add environment variable OPENAI_API_KEY. Could create a .env file and put the variable there too.

  • deno task dev - Run the server with watch mode, for development.
  • deno task debug - Run the server with watch mode and debugging, for development.
  • deno task start - Run the server.

Additional environment variables:

  • OPENAI_MODEL - OpenAI model to use, defaults to gpt-5-nano with minimal reasoning.

REST API Endpoints

  • GET /?image=<image-url>
  • POST / with image key as multipart/form-data.

Response:

{
  "description": "a picture of a cat"
}

Error response:

{
  "error": "Failed to generate description"
}

License

MIT.

References