Sobre o Pose Changer
Muda a pose com uma descrição curta ou uma foto de referência.
Chame com o nome de modelo popnow/pose-changer-v1/edit em POST /jobs/createTask, a partir de 30 créditos por imagem (US$ 0,03).
Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
aspect_ratio | Não | O formato do quadro: horizontal, quadrado ou vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | Sim | A imagem de partida. |
output_format | Não | Tipo de arquivo do resultado. jpeg · png · webp · Padrão: jpeg |
prompt | Não | Optional extra direction added after the built-in pose instruction, e.g. to keep your own background or outfit. |
reference_image_url | Sim | A photo of the pose to copy; only the pose is used. JPEG, PNG or WebP, up to 10 MB. |
seed | Não | Repetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647 |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,001). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos por imagem | ≈ USD |
|---|---|---|
| Padrão | 30 | US$ 0,03 |
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do Pose Changer em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model popnow/pose-changer-v1/edit e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/pose-changer-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Pose Changer
Quanto custa a API do Pose Changer?
O Pose Changer custa 30 créditos (US$ 0,03) por imagem. Os créditos são os mesmos do site (1 crédito = US$ 0,001) e tarefas que falham são reembolsadas.
Qual é o nome de modelo do Pose Changer na API?
Coloque popnow/pose-changer-v1/edit para Mudar pose no campo model de POST /jobs/createTask.
Qual foto é qual?
image_url é a pessoa que você quer reposicionar. reference_image_url é a foto cuja pose você quer copiar; a pessoa dela não é mantida.
Preciso escrever um prompt?
Não. A instrução de transferência de pose do autor do LoRA já vem embutida. Use prompt apenas para direções extras, como manter o fundo ou nomear a roupa.
Qual é a diferença para um editor de imagem comum?
Com as mesmas duas fotos, instrução e seed, o modelo base sem os AnyPose LoRAs colocou a dançarina da foto da pose na primeira cena, em vez de reposicionar a mulher. Com os LoRAs, a mulher assumiu a pose da dançarina.
Por que meu fundo mudou?
Os LoRAs foram treinados para colocar a pessoa na pose da foto de referência. Acrescente "Remove the background of image 2, and replace it with the background of image 1." ao prompt.
Posso usar um desenho ou um manequim 3D como pose?
Fotos de pessoas reais funcionaram melhor nos nossos testes. O autor observa que estilos de arte 2D chapados são fracos.
Quais são os limites da API do Pose Changer?
Proporções: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Tamanho do prompt (caracteres): 1,000; Maior upload: 10 MB. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Pose Changer sem escrever código?
Dá. O Playground roda o Pose Changer com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.