Inicio rápido
De cero a tu primera imagen en tres pasos.
Paso 1: crear una clave
Abre «Mi cuenta → Plataforma API» y pulsa «Crear clave» arriba a la derecha. Ponle un nombre que reconozcas después. Al crearla se copia sola al portapapeles, y después podrás volver a copiarla desde la lista cuando la necesites.
Una clave equivale a tu cuenta y gasta tus créditos. Puedes volver a copiarla desde la lista cuando quieras, así que no repartas copias: cada copia extra amplía la superficie de fuga.
Paso 2: mira qué modelos hay
Guarda la clave en una variable de entorno y lista los modelos. El id de la respuesta es lo que pasarás luego como model.
bash
curl https://open.pikpikgo.com/v1/models \
-H "Authorization: Bearer $PIKPIK_API_KEY"Paso 3: genera una imagen
bash
curl https://open.pikpikgo.com/v1/images/generations \
-H "Authorization: Bearer $PIKPIK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón",
"size": "16:9",
"quality": "2k",
"n": 1
}'Por defecto es síncrono: la llamada espera a que la imagen esté lista y data[0].url ya la contiene, sin necesidad de consultar la tarea. Cada imagen suele tardar más de 30 segundos, así que amplía el tiempo límite del cliente a 300 segundos.
json
{
"created": 1786000246,
"data": [
{ "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón" }
],
"id": "2608101909450810293847",
"object": "image.generation",
"model": "img-std-1",
"status": "succeeded",
"n": 1,
"credits": 10,
"tasks": [
{
"id": "2608101909450810293847",
"status": "succeeded",
"data": [{ "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón" }]
}
]
}Paso 4: ¿prefieres no esperar? Ve en asíncrono
Añade async: true y la llamada responde al momento: status es queued y data sigue vacío, todavía no se ha renderizado nada. Apunta tasks[0].id.
bash
curl https://open.pikpikgo.com/v1/images/generations \
-H "Authorization: Bearer $PIKPIK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón",
"size": "16:9",
"quality": "2k",
"n": 1,
"async": true
}'json
{
"id": "2608101909450810293847",
"object": "image.generation",
"created": 1786000185,
"model": "img-std-1",
"status": "queued",
"n": 1,
"credits": 10,
"tasks": [
{ "id": "2608101909450810293847", "status": "queued", "data": [] }
],
"data": []
}Sondea ese id: cuando status pasa a succeeded, data[0].url contiene la imagen. El vídeo solo funciona así.
bash
curl https://open.pikpikgo.com/v1/tasks/2608101909450810293847 \
-H "Authorization: Bearer $PIKPIK_API_KEY"json
{
"id": "2608101909450810293847",
"object": "image.generation",
"created": 1786000185,
"model": "img-std-1",
"status": "succeeded",
"prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón",
"size": "16:9",
"quality": "2k",
"credits": 10,
"error": "",
"data": [
{ "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón" }
]
}Ejemplos completos
La vía síncrona funciona con el SDK oficial de OpenAI; solo cambia la baseURL:
javascript
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.PIKPIK_API_KEY,
baseURL: 'https://open.pikpikgo.com/v1',
timeout: 300 * 1000,
})
// Síncrono: una sola ida y vuelta devuelve la URL, con el tiempo límite ampliado a 300 segundos
const res = await client.images.generate({
model: 'img-std-1',
prompt: 'una calle cyberpunk bajo la lluvia de noche, reflejos de neón',
size: '1792x1024',
n: 1,
})
console.log(res.data[0].url)La vía asíncrona exige encadenar envío y sondeo, en Node.js:
javascript
const BASE = 'https://open.pikpikgo.com/v1'
const KEY = process.env.PIKPIK_API_KEY
async function call(path, body) {
const res = await fetch(BASE + path, {
method: body ? 'POST' : 'GET',
headers: {
Authorization: `Bearer ${KEY}`,
'Content-Type': 'application/json',
},
body: body ? JSON.stringify(body) : undefined,
})
const json = await res.json()
if (json.error) throw new Error(json.error.message)
return json
}
// Enviar y esperar a que termine: sondear cada 3 segundos y abandonar a los 10 minutos
async function generateImage(prompt) {
const job = await call('/images/generations', { prompt, size: '16:9', async: true })
const id = job.tasks[0].id
for (let i = 0; i < 200; i++) {
const task = await call(`/tasks/${id}`)
if (task.status === 'succeeded') return task.data[0].url
if (task.status === 'failed') throw new Error(task.error || 'fallo en la generación')
await new Promise((r) => setTimeout(r, 3000))
}
throw new Error('tiempo de espera agotado')
}
generateImage('una calle cyberpunk bajo la lluvia de noche, reflejos de neón').then(console.log)Python (aquí con vídeo y un intervalo de sondeo mayor):
python
import os, time, requests
BASE = "https://open.pikpikgo.com/v1"
KEY = os.environ["PIKPIK_API_KEY"]
HEAD = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}
def call(path, body=None):
if body is None:
r = requests.get(BASE + path, headers=HEAD, timeout=30)
else:
r = requests.post(BASE + path, headers=HEAD, json=body, timeout=60)
data = r.json()
if "error" in data:
raise RuntimeError(data["error"]["message"])
return data
def generate_video(prompt, seconds=5):
job = call("/video/generations", {"prompt": prompt, "duration": seconds})
# El vídeo suele tardar de 1 a 5 minutos; sondear cada 5 segundos basta, y hacerlo más a menudo solo consume límite
for _ in range(200):
task = call(f"/video/generations/{job['task_id']}")
if task["status"] == "succeeded":
return task["url"]
if task["status"] == "failed":
raise RuntimeError(task["error"] or "fallo en la generación")
time.sleep(5)
raise TimeoutError("tiempo de espera agotado")
print(generate_video("travelling lento hacia delante, una chica se gira y sonríe"))