fofr/batch-image-captioner
Caption images in batches using GPT-5 or Claude
Public
2
runs
Run fofr/batch-image-captioner with an API
Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.
Input schema
The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.
| Field | Type | Default value | Description |
|---|---|---|---|
| model |
None
|
gpt-5
|
Model to use for image captioning
|
| image_zip |
string
|
ZIP archive containing images to process
|
|
| caption_prefix |
string
|
|
Optional prefix for image captions
|
| caption_suffix |
string
|
|
Optional suffix for image captions
|
| system_prompt |
string
|
Write a four sentence caption for this image. In the first sentence describe the style and type (painting, photo, etc) of the image. Describe in the remaining sentences the contents and composition of the image. Only use language that would be used to prompt a text to image model. Do not include usage. Comma separate keywords rather than using "or". Precise composition is important. Avoid phrases like "appears to be", "conveys a sense of" and "capturing the", just use the terms themselves.
Good examples are:
"Photo of an alien woman with a glowing halo standing on top of a mountain, wearing a white robe and silver mask in the futuristic style with futuristic design, sky background, soft lighting, dynamic pose, a sense of future technology, a science fiction movie scene rendered in the Unreal Engine."
"A scene from the cartoon series Masters of the Universe depicts Man-At-Arms wearing a gray helmet and gray armor with red gloves. He is holding an iron bar above his head while looking down on Orko, a pink blob character. Orko is sitting behind Man-At-Arms facing left on a chair. Both characters are standing near each other, with Orko inside a yellow chestplate over a blue shirt and black pants. The scene is drawn in the style of the Masters of the Universe cartoon series."
"An emoji, digital illustration, playful, whimsical. A cartoon zombie character with green skin and tattered clothes reaches forward with two hands, they have green skin, messy hair, an open mouth and gaping teeth, one eye is half closed."
|
System prompt for image analysis
|
{
"type": "object",
"title": "Input",
"required": [
"image_zip"
],
"properties": {
"model": {
"enum": [
"claude-4-sonnet",
"gpt-5",
"gpt-5-mini",
"gpt-5-nano"
],
"type": "string",
"title": "model",
"description": "Model to use for image captioning",
"default": "gpt-5",
"x-order": 0
},
"image_zip": {
"type": "string",
"title": "Image Zip",
"format": "uri",
"x-order": 1,
"description": "ZIP archive containing images to process"
},
"system_prompt": {
"type": "string",
"title": "System Prompt",
"default": "Write a four sentence caption for this image. In the first sentence describe the style and type (painting, photo, etc) of the image. Describe in the remaining sentences the contents and composition of the image. Only use language that would be used to prompt a text to image model. Do not include usage. Comma separate keywords rather than using \"or\". Precise composition is important. Avoid phrases like \"appears to be\", \"conveys a sense of\" and \"capturing the\", just use the terms themselves.\n\nGood examples are:\n\n\"Photo of an alien woman with a glowing halo standing on top of a mountain, wearing a white robe and silver mask in the futuristic style with futuristic design, sky background, soft lighting, dynamic pose, a sense of future technology, a science fiction movie scene rendered in the Unreal Engine.\"\n\n\"A scene from the cartoon series Masters of the Universe depicts Man-At-Arms wearing a gray helmet and gray armor with red gloves. He is holding an iron bar above his head while looking down on Orko, a pink blob character. Orko is sitting behind Man-At-Arms facing left on a chair. Both characters are standing near each other, with Orko inside a yellow chestplate over a blue shirt and black pants. The scene is drawn in the style of the Masters of the Universe cartoon series.\"\n\n\"An emoji, digital illustration, playful, whimsical. A cartoon zombie character with green skin and tattered clothes reaches forward with two hands, they have green skin, messy hair, an open mouth and gaping teeth, one eye is half closed.\"\n",
"x-order": 4,
"description": "System prompt for image analysis"
},
"caption_prefix": {
"type": "string",
"title": "Caption Prefix",
"default": "",
"x-order": 2,
"description": "Optional prefix for image captions"
},
"caption_suffix": {
"type": "string",
"title": "Caption Suffix",
"default": "",
"x-order": 3,
"description": "Optional suffix for image captions"
}
}
}
Output schema
The shape of the response you’ll get when you run this model with an API.
Schema
{
"type": "string",
"title": "Output",
"format": "uri"
}
Example API response
View prediction
'https://replicate.delivery/xezq/F0r9SRjsHB7qOpwyIr7doekGARbz0X39dAVYPdiBRcGMehMVA/captioned_images.zip'