Procesamiento por lotes
On this page
No hay un endpoint de lote separado. La lista es el lote, y una sola solicitud devuelve todos los resultados. Enviar un elemento y obtener la respuesta directamente; enviar varios y los resultados se devuelven en el orden en que se enviaron, uno por elemento.
Una lista se factura como una sola solicitud: diez CV en una sola llamada /parse/ cuestan $0.01. Consulta Precios y facturación.
Límites por operación
| Operación | Campo de lista | Límite | Alias de un solo elemento |
|---|---|---|---|
/parse/ | files | 10 documentos | file |
/evaluate/ | resume_pdfs, frente a un puesto | 10 documentos | resume_pdf |
/translate/ | texts, o files | 200 cadenas y 50.000 caracteres, o 10 documentos | text |
/detect-language/ | texts | 200 textos | text |
/summary/ | JSON matriz de entrevistas, o repetida media | 10 entrevistas o archivos | un objeto único |
/prompt/ | ninguno | una instrucción por llamada (con estado) | ninguno |
/parse/async, /evaluate/async | file_urls, resume_urls | 25 enlaces | ninguno |
Tres propiedades para diseñar alrededor
- El orden se conserva.
results[i]siempre pertenece a la entradai. - Los errores son por elemento. Un documento malo devuelve una entrada de error junto a las entradas exitosas, y el estado HTTP permanece
200. - Las respuestas por lotes están dentro del presupuesto de la solicitud. Los elementos que nunca se iniciaron antes de que se agotara el presupuesto de 300 segundos devuelven una entrada
504en lugar de hundir toda la solicitud. Vuelva a enviar solo esos.
Reenviar un elemento fallido siempre es seguro. No puede crear duplicados o registros incompletos.
Retrasos mayores que una solicitud
Para una cola de tareas pendientes, prefiera el carril asíncrono :POST /parse/async o POST /evaluate/async , que admite hasta 25 enlaces por tarea, responde al mismo tiempo y entrega el resultado mediante callback o sondeo.
El trabajo pesado ejecuta tres operaciones al mismo tiempo en la capacidad compartida en todo el servicio; más allá de eso, las solicitudes se ponen en cola en lugar de fallar. El rendimiento sostenido es aproximadamente de 2 a 4 CV por minuto y varía según la carga. Si necesita significativamente más, indíquenos el volumen. Vea Límites de velocidad.
El análisis de CV tarda de 40 a 90 segundos por documento. Trate el procesamiento de CV como un trabajo en segundo plano, no como una carga de página, y mantenga el tiempo de espera del cliente por encima de cinco minutos.
Evaluación de una cola de tareas pendientes contra un trabajo
Registre la descripción una vez (gratuito), luego envíe listas de CV contra el job_id que devuelve. El procesamiento en línea job_details hace el mismo trabajo, pero registrar mantiene una cola de tareas pendientes larga para no volver a enviar el mismo párrafo con cada solicitud.
# 1. Register the job. Returns a job_id.
curl -X POST https://api.curriculo.me/public/jobs/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-H 'Content-Type: application/json' \
-d '{"job_details": "Senior backend engineer, Python and FastAPI, Seoul", "label": "BE-Seoul"}'
# -> {"job_id": "job_abc123", "label": "BE-Seoul"}
# 2. Evaluate a list of CVs against it.
curl -X POST https://api.curriculo.me/public/evaluate/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-F 'resume_pdfs=@candidate_a.pdf' \
-F 'resume_pdfs=@candidate_b.docx' \
-F 'job_id=job_abc123'Updated