#AIShoot
Select a photo template and replace the characters in the uploaded photos into the photo scene.
http
POST /v1/images/shootFirst call GET /v1/templates?capability=image.shoot to get the template.
| Parameters | Type | Required | Description |
|---|---|---|---|
template_id | string | Yes | Official or own AI Shoot template ID |
face | string | Yes | Clear front face picture URL or base64 |
webhook_url | string | No | Completion 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.
| Method | Interface | Description |
|---|---|---|
| GET | /v1/shoot-templates | List your own templates |
| POST | /v1/shoot-templates | Create 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.
