Skip to content

#AIShoot

Select a photo template and replace the characters in the uploaded photos into the photo scene.

http
POST /v1/images/shoot

First call GET /v1/templates?capability=image.shoot to get the template.

ParametersTypeRequiredDescription
template_idstringYesOfficial or own AI Shoot template ID
facestringYesClear front face picture URL or base64
webhook_urlstringNoCompletion callback address
bash
curl -X POST https://api.modelgo.moneygo.ai/v1/images/shoot \
  -H "Authorization: Bearer sk-your-key" \
  -H "Idempotency-Key: shoot-order-1001" \
  -H "Content-Type: application/json" \
  -d '{"template_id":"shoot_1","face":"https://example.com/face.jpg"}'

Custom AI Shoot template ​

Custom templates are only visible to the current account. After creation, the ID starting with ushoot_ is returned, which can be directly used as the template_id of the generated interface.

MethodInterfaceDescription
GET/v1/shoot-templatesList your own templates
POST/v1/shoot-templatesCreate Template
PATCH/v1/shoot-templates/{id}Modify name, target_url or cover_url
DELETE/v1/shoot-templates/{id}Delete template, return 204 successfully
bash
# Create a template
curl -X POST https://api.modelgo.moneygo.ai/v1/shoot-templates \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name":"My photo shoot",
    "target_url":"https://example.com/shoot.jpg",
    "cover_url":"https://example.com/cover.jpg"
  }'

# Use the returned ushoot_xxx ID to generate directly
curl -X POST https://api.modelgo.moneygo.ai/v1/images/shoot \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"template_id":"ushoot_xxx","face":"https://example.com/face.jpg"}'

target_url must be a public image address accessible to the generation service; cover_url is for display only.

Copyright © 2026 ModelGo all rights reserved | Technology powered by MoneyGo.ai