# Testa kreativ med API:t Ladda upp annonser och annat kreativ, testa dem med dina kunders digitala tvillingar och läs resultattavlan från din egen kod. Källa: https://point11.ai/sv/docs/mcp/creative-testing Uppdaterad: 2026-10-18 ## Översikt Ett kreativtest visar dina annonser, bilder, videor eller ljud för dina kunders digitala tvillingar och ber varje tvilling att betygsätta dem. Du kan köra samma test som du kör från **Studio > Assets > Test existing assets** från din egen kod, till exempel direkt efter att en designer har exporterat en fil från Canva eller Adobe. Du behöver en [API-nyckel](/sv/docs/mcp/overview) med skrivåtkomst till Research och en målgrupp som du har konfigurerat i Point11: en företagsprofil och dess kunder. Varje anrop nedan skickar nyckeln som `Authorization: Bearer $POINT11_API_KEY`, och varje anrop som ändrar något skickar ett nytt UUID i `Idempotency-Key`. ## Ladda upp varje kreativ Ladda upp varje fil med tre anrop. Reservera först uppladdningen: skicka filens namn, typ, exakta storlek i byte och SHA-256 (en video skickar ingen SHA-256): ```bash curl https://point11.ai/api/v1/research/study-attachments/reserve-upload-v4 \ -H "Authorization: Bearer $POINT11_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"filename": "summer-ad.png", "mediaType": "image/png", "byteLength": 482113, "sha256": ""}' ``` Skicka sedan filen som brödtext i `upload`-anropet i svaret, med exakt dess metod, URL och rubriker, innan det går ut en minut senare. Avsluta till sist uppladdningen med bilagans `id` och den `etag` som uppladdningen returnerade: ```bash curl https://point11.ai/api/v1/research/study-attachments/complete-upload-v3 \ -H "Authorization: Bearer $POINT11_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"id": "", "etag": ""}' ``` Bilder (PNG, JPEG, WebP) får vara upp till 3 750 000 byte, det mesta en bild kan föra med sig till varje AI-modell en tvilling kan köras på; PDF:er och ljud (MP3, WAV) upp till 4 MiB och videor (MP4, WebM) upp till 100 MiB och 3 minuter. Tvillingarna ser en video som tidsstämplade bildrutor och dess transkription, så vänta tills `GET /api/v1/research/study-attachments-v2/{id}` visar att dess storyboard är klart. ## Starta testet Ange de uppladdade filerna, vad du vill ta reda på, målgruppen och hur tvillingarna ska möta kreativet: ```bash curl https://point11.ai/api/v1/research/creative-tests/start \ -H "Authorization: Bearer $POINT11_API_KEY" \ -H "Idempotency-Key: $TEST_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Summer ads", "brief": "Which ad makes people want to book a visit, and why?", "sellerProfileId": null, "contentLanguage": "en", "audience": { "audienceProfileId": "", "targetedGroupIds": null, "targetedCustomerIds": null, "targetInterviewCount": 50 }, "studyMode": {"kind": "first_impressions"}, "metrics": ["stopping_power", "clarity", "appeal", "intent_to_act"], "platforms": ["Facebook", "Instagram"], "attachments": [ {"artifactId": "", "filename": "summer-ad.png", "mediaType": "image/png", "byteLength": 482113} ] }' ``` - **Målgrupp.** `audienceProfileId` är id:t för din företagsprofil från `GET /api/v1/business/profiles`. Lämna `targetedGroupIds` tomt för att välja bland alla dess kunder, eller ange upp till 20 sparade målgrupper. - **Första intryck eller en köpsituation.** `first_impressions` visar kreativet för varje tvilling som den är. `buying_scenario` med en `direction` placerar först varje tvilling i den köpsituation du beskriver. - **Mått.** Varje mått blir en betygsfråga per kreativ på en gemensam skala, plus en följdfråga, så ett test ställer kreativ × (mått + 1) frågor, högst 100. Med 4 mått kan du testa upp till 20 kreativ. Plattformsanpassning kräver minst en plattform. Testet svarar `202` direkt. Spara den `Idempotency-Key` du skickade: från och med nu namnger den testet. ## Följ testet Medan Point11 läser ditt kreativ och förbereder tvillingarna läser du testet med den nyckeln: ```bash curl https://point11.ai/api/v1/research/creative-tests/$TEST_KEY \ -H "Authorization: Bearer $POINT11_API_KEY" ``` `status` är `preparing`, sedan `launched`, `failed` eller `unsupported`, och `phase` visar hur långt det har kommit. Bara nyckeln som startade ett test kan läsa det på det här sättet. När det är `launched` namnger `campaignId` och `runId` dess intervjuer och resultat. Intervjuerna tar längre tid, så i stället för att läsa varje test läser du organisationens aktivitetsrevision var 30:e till 60:e sekund. Den ändras när en studie avslutas eller dess resultat publiceras, så ett enda anrop täcker alla dina tester: ```bash curl https://point11.ai/api/v1/campaigns/activity-revisions/organization \ -H "Authorization: Bearer $POINT11_API_KEY" ``` Läs resultaten när `products.research` ändras. ## Läs resultattavlan ```bash curl "https://point11.ai/api/v1/research/results-v7/$CAMPAIGN_ID?runId=$RUN_ID" \ -H "Authorization: Bearer $POINT11_API_KEY" ``` Resultaten ger svaren på varje fråga, en sammanfattning med citat, hur många intervjuer som slutfördes och resultattavlan: varje mått för varje kreativ och totalt. Resultaten är simulerad forskning med dina kunders digitala tvillingar, inte uppmätta klick, försäljningar eller konverteringar. ## Kostnader och gränser - Ett kreativtest faktureras som vilken Research-studie som helst: varje levererad intervju räknas mot din plan till priset för en Research-intervju, och att läsa kreativet och förbereda tvillingarna förbrukar Alpha-krediter till deras exakta kostnad. - Varje nyckel har 100 anrop per minut för API:t och MCP-servern tillsammans. En nyckel kan starta ungefär 6 tester per minut och ladda upp 128 filer per minut och 300 per dag. När en budget tar slut får du `429`; vänta det antal sekunder som `Retry-After` anger. - Skicka ett anrop igen med samma `Idempotency-Key` för att försöka igen på ett säkert sätt. Att försöka starta igen ger dig samma test tillbaka, och inget debiteras två gånger.