MAI Image 2.7 API
Planeje mudanças com o modelo de edição de imagens Microsoft MAI Image 2.7. No Playground do MAI Image API, combine o original com instruções claras sobre cena, luz, texto e detalhes a preservar.
Configuração do MAI Image 2.7 API
- Imagem original de arquivo ou URL
- Instruções de edição no prompt
- Configuração em Form e JSON
Indique o que deve mudar e quais detalhes devem ser preservados.
Escolha uma imagem e descreva as alterações.
Prepare edições específicas com MAI Image 2.7 API
Comece com sua imagem e um objetivo claro. Use o espaço de edição para separar as mudanças desejadas da composição, dos materiais e dos detalhes que devem permanecer iguais.
Exemplo da MAI Image 2.7 API: edição de imagens
Use estes exemplos para montar uma requisição de edição com a imagem original e as instruções, depois consulte a tarefa para obter o resultado.
- 1
Autentique a requisição da MAI Image 2.7 API
Salve sua chave API da APIMart na variável de ambiente APIMART_API_KEY. Envie-a como Authorization: Bearer <key> tanto ao solicitar a edição quanto ao consultar a tarefa.
- 2
Envie uma tarefa de edição de imagem
Envie POST /v1/images/generations com model definido como mai-image-2.7, as instruções de edição em prompt e uma URL HTTP ou HTTPS da imagem original em image_urls. Leia o ID da tarefa em data[0].task_id na resposta.
- 3
Obtenha a imagem editada
Consulte a tarefa com GET /v1/tasks/{task_id}. Se o status for completed, leia a URL da imagem em data.result.images[0].url[0]. Se o status for failed, consulte o motivo em data.error.message.
Consulte a documentação da APIMart para autenticação e uso geral da API APIMart.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mai-image-2.7",
"prompt": "Coloque o produto desta imagem sobre uma bancada de cozinha de mármore sob uma luz suave da manhã, mantendo sua forma e seu rótulo inalterados.",
"image_urls": [
"https://example.com/source-image.jpg"
]
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "mai-image-2.7",
"prompt": "Coloque o produto desta imagem sobre uma bancada de cozinha de mármore sob uma luz suave da manhã, mantendo sua forma e seu rótulo inalterados.",
"image_urls": [
"https://example.com/source-image.jpg"
]
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Parâmetros da MAI Image 2.7 API
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
model | string | Sim | Padrão: mai-image-2.7 | Valor do modelo usado no exemplo desta página: mai-image-2.7. |
prompt | string | Sim | Padrão: — | Descreva as alterações desejadas e os elementos da imagem original que devem ser preservados. |
image_urls | array | Sim | Padrão: — | Um array contendo exatamente uma URL HTTP ou HTTPS da imagem original a ser editada. |
