Lançamento PyPI

image2url para Python — envie imagens e receba URLs permanentes

O pacote oficial do Image2URL no PyPI. Mantenha uploads no servidor, imponha limites de tamanho e retorne links prontos para CDN com JSON estruturado para logs, notebooks e scripts de CI.

Política de cache

public, max-age=31536000

Validação

MIME + limite de tamanho

Formatos

URL + JSON de metadados

Python quick start
Type-safe responses
from image2url import upload_image, Image2URLClient

client = Image2URLClient(
    endpoint="https://www.image2url.com/api/upload",
    timeout=15,
    max_size_mb=2,
)

result = client.upload_image("logo.png", filename="brand-logo.png")
print(result.url)
print(result.raw)  # structured JSON with filename, size, mimeType, uploadedAt

Cronograma de lançamento

Hoje

Lançamento PyPI

Publicamos image2url 0.1.0 no PyPI com cliente tipado, entrada CLI, limites de tamanho e endpoints via variáveis de ambiente.

Entregue

Esta semana

Docs e exemplos

Adicionar mais trechos prontos para FastAPI, Flask e Django; melhorar README e anotações de tipo.

Em foco

Em breve

Uploads assinados

Suporte opcional para uploads assinados e retomáveis para arquivos maiores.

Planejado

Em breve

Transformações

Transformações de imagem (resize/formato) com headers de cache para CDN e URLs determinísticas.

Planejado

Em breve

Hooks de telemetria

Códigos de erro observáveis e orientações de retry para pipelines de CI/CD.

Planejado

Seguro por padrão

Uploads HTTPS, validação MIME, limites de tamanho e codificação de nomes de arquivo com headers de cache ajustados para CDNs.

Tipado e simples

API mínima: upload_image({ file, filename? }). JSON estruturado para logs e dashboards.

Roteiro aberto

Ajude a adicionar uploads assinados, transformações, hooks de telemetria e presets de frameworks. Issues e PRs são bem-vindos.

Convite open source

Junte-se ao projeto image2url-pypi

Compartilhe padrões reais, melhore a documentação, adicione testes e proponha recursos como uploads assinados e transformações.

FAQ

O que é image2url (PyPI)?

Um cliente Python leve e uma CLI que enviam imagens para o endpoint image2url e retornam URLs prontas para CDN com metadados.

Como instalar?

Execute pip install image2url. Entrada da CLI: image2url path/to/file.png.

Preciso de chaves de API?

O endpoint padrão em image2url.com oferece cota gratuita baseada em IP. Você pode apontar para sua própria instância via IMAGE2URL_ENDPOINT.

É open source?

Sim. Contribua no GitHub em github.com/image2url/image2url-pypi. Issues e PRs são bem-vindos.

O que recebo na resposta?

Uma URL permanente mais filename, mimeType, size, uploadedAt e JSON estruturado adequado para logs.

Como a confiabilidade é tratada?

Uploads via HTTPS, limites de tamanho, validação MIME, headers de cache e erros explícitos para observabilidade.

Image2URL PyPI SDK | Cliente Python e CLI para uploads instantâneos de imagens