/caption

pip install moondream pillow

npm install moondream

# No installation needed

import moondream as md
from PIL import Image
 
# Initialize with API key
model = md.vl(api_key="your-api-key")
 
# Load an image
image = Image.open("path/to/image.jpg")
 
# Generate a caption
caption = model.caption(image)["caption"]
print("Caption:", caption)
 
# Stream the response
for chunk in model.caption(image, stream=True)["caption"]:
    print(chunk, end="", flush=True)

import { vl } from "moondream";
import fs from "fs";
 
const model = new vl({ apiKey: "your-api-key" });
const image = fs.readFileSync("path/to/image.jpg");
 
async function main() {
  // Regular response
  const caption = await model.caption({
    image,
    length: "normal"
  });
  console.log(caption);
 
  // Streamed response
  const stream = await model.caption({
    image,
    length: "normal",
    stream: true
  });
  for await (const chunk of stream.caption) process.stdout.write(chunk);
}
 
main();

curl --location 'https://api.moondream.ai/v1/caption' \
--header 'X-Moondream-Auth: <API KEY FROM console.moondream.ai>' \
--header 'Content-Type: application/json' \
--data '{
    "image_url": "data:image/jpeg;base64,<BASE64-STRING>",
    "length": "long",
    "stream": false
}'