media

Importar una foto o un vídeo de archivo

Copia un resultado de búsqueda, identificado por proveedor e id, en los archivos multimedia del sitio (imágenes de hasta 2400 px de ancho y vídeos de hasta Full HD), junto con su texto alternativo y su atribución. Gratis.

POST/v1/sites/{site_id}/media/stock

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/media/stock' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "pixabay",
  "id": "<string>"
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/media/stock"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"provider\":\"pixabay\",\"id\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/media/stock", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "provider": "pixabay",
    "id": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>/media/stock");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"provider\":\"pixabay\",\"id\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.atelier201.com/v1/sites/<site_id>/media/stock", bytes.NewBuffer([]byte("{\"provider\":\"pixabay\",\"id\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/sites/<site_id>/media/stock"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"provider\":\"pixabay\",\"id\":\"<string>\"}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/sites/<site_id>/media/stock")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"provider\":\"pixabay\",\"id\":\"<string>\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "path": "<string>",
    "url_path": "<string>",
    "mime": "<string>",
    "size": 123,
    "alt": null,
    "credit": null,
    "source_url": null,
    "keep_original": true,
    "source": {},
    "next_action": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

Requiere sites:write. No consume créditos.

Envía provider e id del resultado de búsqueda. El archivo se copia en los recursos multimedia del sitio: las fotos pueden tener un máximo de 2400 píxeles de ancho y los vídeos, una resolución máxima de Full HD y un tamaño máximo de 20 MB. Si el nombre ya está en uso, se añade un sufijo, así que la importación nunca sustituye un archivo que ya tenga el sitio.

El recurso conserva credit (“Photo by Jane Doe on Pixabay”) y source_url. Pixabay no exige que se incluya el crédito en el sitio, pero es recomendable añadir una breve línea de créditos.

Las imágenes de archivo crean ambiente, pero nunca sustituyen a los productos, las personas ni las instalaciones reales del negocio.

Se aplica el mismo límite de 30 búsquedas e importaciones por minuto y espacio de trabajo que a las búsquedas.

Autorizaciones

Authorizationbearerin headerrequired

Parámetros de ruta

site_idstringrequired

El ID del sitio o su slug (la dirección antes de .atelier201.page).

Cuerpo

application/jsonrequired

providerenum<string>requiredone of: pixabay

idstringrequiredlength: 1–20 chars

El id del resultado, obtenido de la búsqueda.

kindenum<string>one of: image, video

filenamestringlength: 1–100 chars

Un nombre sin extensión; de forma predeterminada, se usa la descripción.

altstringlength: ≤ 300 chars

Qué muestra, para quienes no pueden verlo. De forma predeterminada, se usa la descripción de la biblioteca.

Respuesta

application/json

Importar una foto o un vídeo de stock

dataRecord<string, object>required

Show child attributes

data.pathstringrequired

data.url_pathstringrequired

data.mimestringrequired

data.sizeintegerrequiredrange: -9007199254740991–9007199254740991

data.altstringnullrequired

data.creditstringnullrequired

Quién lo creó, cuando la licencia lo requiere: "Photo by Jane Doe on Pixabay", "Generated with Seedream 5 Lite (ByteDance)". Null si se ha subido el archivo.

data.source_urlstringnullrequired

La página de imágenes de stock de la que procede, o null.

data.keep_originalbooleanrequired

Se almacena exactamente como se ha subido y nunca se vuelve a codificar durante una compilación. De lo contrario, las imágenes de más de 200 KB se comprimen al subirlas (máximo 2000 px, objetivo de 150 KB, calidad de 75 o superior y metadatos eliminados).

data.sourceRecord<string, object>required

data.next_actionstringrequired

request_idstringrequired

curl --request POST \ --url 'https://api.atelier201.com/v1/sites/<site_id>/media/stock' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "provider": "pixabay", "id": "<string>" }'

{ "data": { "path": "<string>", "url_path": "<string>", "mime": "<string>", "size": 123, "alt": null, "credit": null, "source_url": null, "keep_original": true, "source": {}, "next_action": "<string>" }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Importar una foto o un vídeo de archivo

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies